Acquisitions units (v1.1)

http://github.com/folio-org/mod-orders

Acquisitions units
/acquisitions-units

Acquisitions units

CRUD APIs used to manage acquisitions units.

/acquisitions-units

POST /acquisitions-units/units

Create new acquisitions unit

POST /acquisitions-units/units

Query Parameters

lang: (string - default: en - pattern: [a-zA-Z]{2})
Requested language. Optional. [lang=en]

Body

Media type: application/json

Type: json

Content:

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "Acquisitions Units",
  "type": "object",
  "properties": {
    "id": {
      "description": "UUID of this acquisitions unit record",
      "$ref": "../../common/schemas/uuid.json"
    },
    "name": {
      "description": "a name for this acquisitions unit",
      "type": "string"
    },
    "isDeleted": {
      "description": "If true, the record is marked for deletion at some point. This prevents it from being assigned to any record.",
      "type": "boolean",
      "default": false
    },
    "protectCreate": {
      "description": "if true, only members can create records associated with this acq unit.",
      "type": "boolean",
      "default": true
    },
    "protectRead": {
      "description": "if true, only members can read/view records associated with this acq unit.",
      "type": "boolean",
      "default": false
    },
    "protectUpdate": {
      "description": "if true, only members can update records associated with this acq unit.",
      "type": "boolean",
      "default": true
    },
    "protectDelete": {
      "description": "if true, only members can delete records associated with this acq unit.",
      "type": "boolean",
      "default": true
    },
    "metadata": {
      "type": "object",
      "$ref": "../../../raml-util/schemas/metadata.schema",
      "readonly": true
    }
  },
  "additionalProperties": false,
  "required": [
    "name",
    "isDeleted"
  ]
}

Example:

{
  "name": "main",
  "isDeleted": false,
  "protectCreate": true,
  "protectRead": false,
  "protectUpdate": true,
  "protectDelete": true
}

Response 201

Returns a newly created item, with server-controlled fields like 'id' populated

Headers

Location: required (string)
URI to the created unit item

Body

Media type: application/json

Type: any

Example:

{
  "name": "main",
  "isDeleted": false,
  "protectCreate": true,
  "protectRead": false,
  "protectUpdate": true,
  "protectDelete": true
}

Response 400

Bad request, e.g. malformed request body or query parameter. Details of the error (e.g. name of the parameter or line/character number with malformed data) provided in the response.

Body

Media type: text/plain

Type: any

Example:

"unable to add unit -- malformed JSON at 13:3"

Response 401

Not authorized to perform requested action

Body

Media type: text/plain

Type: any

Example:

unable to create units -- unauthorized

Response 422

Validation errors

Body

Media type: application/json

Type: json

Content:

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "A set of errors",
  "type": "object",
  "properties": {
    "errors": {
      "description": "List of errors",
      "id": "errors",
      "type": "array",
      "items": {
        "type": "object",
        "$ref": "error.schema"
      }
    },
    "total_records": {
      "type": "integer"
    }
  }
}

Example:

{
  "errors": [
    {
      "message": "may not be null",
      "type": "1",
      "code": "-1",
      "parameters": [
        {
          "key": "moduleTo",
          "value": "null"
        }
      ]
    }
  ]
}

Response 500

Internal server error, e.g. due to misconfiguration

Body

Media type: text/plain

Type: any

Example:

Internal server error, contact administrator

GET /acquisitions-units/units

Get list of acquisitions units. In case client does not specify search criteria by "isDeleted" property, the logic will search for records with "isDeleted==false"

GET /acquisitions-units/units

Query Parameters

query: (string)
A query expressed as a CQL string (see dev.folio.org/reference/glossary#cql) using valid searchable fields. The first example below shows the general form of a full CQL query, but those fields might not be relevant in this context.
with valid searchable fields: for example protectRead
Example:
```
(username=="ab*" or personal.firstName=="ab*" or personal.lastName=="ab*") and active=="true" sortby personal.lastName personal.firstName barcode

["protectRead", "false"]
```
offset: (integer - default: 0 - minimum: 0 - maximum: 2147483647)
Skip over a number of elements by specifying an offset value for the query
Example:
```
0
```
limit: (integer - default: 10 - minimum: 0 - maximum: 2147483647)
Limit the number of elements returned in the response
Example:
```
10
```
lang: (string - default: en - pattern: [a-zA-Z]{2})
Requested language. Optional. [lang=en]

Response 200

Returns a list of unit items

Body

Media type: application/json

Type: json

Content:

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "collection of acquisitions unit records",
  "type": "object",
  "properties": {
    "acquisitionsUnits": {
      "description": "collection of acquisitions unit records",
      "type": "array",
      "id": "acquisitionsUnits",
      "items": {
        "type": "object",
        "$ref": "acquisitions_unit.json"
      }
    },
    "totalRecords": {
      "description": "The number of objects contained in this collection",
      "type": "integer"
    }
  },
  "additionalProperties": false,
  "required": [
    "acquisitionsUnits",
    "totalRecords"
  ]
}

Example:

{
   "acquisitionsUnits":
     [
       {
          "name": "main",
          "isDeleted": false,
          "protectCreate": true,
          "protectRead": false,
          "protectUpdate": true,
          "protectDelete": true
       },
       {
          "name": "law",
          "isDeleted": false,
          "protectCreate": true,
          "protectRead": true,
          "protectUpdate": true,
          "protectDelete": true
       },
       {
         "name": "general",
         "isDeleted": true,
         "protectCreate": false,
         "protectRead": false,
         "protectUpdate": false,
         "protectDelete": false
       }
     ],
   "totalRecords": 3
}

Response 400

Bad request, e.g. malformed request body or query parameter. Details of the error (e.g. name of the parameter or line/character number with malformed data) provided in the response.

Body

Media type: text/plain

Type: any

Example:

unable to list units -- malformed parameter 'query', syntax error at column 6

Response 401

Not authorized to perform requested action

Body

Media type: text/plain

Type: any

Example:

unable to list units -- unauthorized

Response 500

Internal server error, e.g. due to misconfiguration

Body

Media type: text/plain

Type: any

Example:

internal server error, contact administrator

PUT /acquisitions-units/units/{id}

Update acquisitions unit

PUT /acquisitions-units/units/{id}

URI Parameters

id: required (string - pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$)
The UUID of an acquisitions unit

Query Parameters

lang: (string - default: en - pattern: [a-zA-Z]{2})
Requested language. Optional. [lang=en]

Body

Media type: application/json

Type: json

Content:

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "Acquisitions Units",
  "type": "object",
  "properties": {
    "id": {
      "description": "UUID of this acquisitions unit record",
      "$ref": "../../common/schemas/uuid.json"
    },
    "name": {
      "description": "a name for this acquisitions unit",
      "type": "string"
    },
    "isDeleted": {
      "description": "If true, the record is marked for deletion at some point. This prevents it from being assigned to any record.",
      "type": "boolean",
      "default": false
    },
    "protectCreate": {
      "description": "if true, only members can create records associated with this acq unit.",
      "type": "boolean",
      "default": true
    },
    "protectRead": {
      "description": "if true, only members can read/view records associated with this acq unit.",
      "type": "boolean",
      "default": false
    },
    "protectUpdate": {
      "description": "if true, only members can update records associated with this acq unit.",
      "type": "boolean",
      "default": true
    },
    "protectDelete": {
      "description": "if true, only members can delete records associated with this acq unit.",
      "type": "boolean",
      "default": true
    },
    "metadata": {
      "type": "object",
      "$ref": "../../../raml-util/schemas/metadata.schema",
      "readonly": true
    }
  },
  "additionalProperties": false,
  "required": [
    "name",
    "isDeleted"
  ]
}

Example:

{
  "id": "7ec2ed06-0504-40dc-bc53-7515955ff0cb",
  "name": "main",
  "isDeleted": false,
  "protectCreate": true,
  "protectRead": false,
  "protectUpdate": true,
  "protectDelete": true
}

Response 204

Item successfully updated

Response 400

Bad request, e.g. malformed request body or query parameter. Details of the error (e.g. name of the parameter or line/character number with malformed data) provided in the response.

Body

Media type: text/plain

Type: any

Example:

"unable to update unit -- malformed JSON at 13:4"

Response 404

Item with a given ID not found

Body

Media type: text/plain

Type: any

Example:

"unit not found"

Response 422

Validation errors

Body

Media type: application/json

Type: json

Content:

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "A set of errors",
  "type": "object",
  "properties": {
    "errors": {
      "description": "List of errors",
      "id": "errors",
      "type": "array",
      "items": {
        "type": "object",
        "$ref": "error.schema"
      }
    },
    "total_records": {
      "type": "integer"
    }
  }
}

Example:

{
  "errors": [
    {
      "message": "may not be null",
      "type": "1",
      "code": "-1",
      "parameters": [
        {
          "key": "moduleTo",
          "value": "null"
        }
      ]
    }
  ]
}

Response 500

Internal server error, e.g. due to misconfiguration

Body

Media type: text/plain

Type: any

Example:

internal server error, contact administrator

DELETE /acquisitions-units/units/{id}

In order to avoid reference integrity issues when deleting acquisition units that are assigned to records, the logic implements a "soft delete". Update acquisitions unit setting the "isDeleted" field to true

DELETE /acquisitions-units/units/{id}

URI Parameters

id: required (string - pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$)
The UUID of an acquisitions unit

Query Parameters

lang: (string - default: en - pattern: [a-zA-Z]{2})
Requested language. Optional. [lang=en]

Response 204

Item deleted successfully

Response 400

Bad request, e.g. malformed request body or query parameter. Details of the error (e.g. name of the parameter or line/character number with malformed data) provided in the response.

Body

Media type: text/plain

Type: any

Example:

"unable to delete unit -- constraint violation"

Response 404

Item with a given ID not found

Body

Media type: text/plain

Type: any

Example:

"unit not found"

Response 500

Internal server error, e.g. due to misconfiguration

Body

Media type: text/plain

Type: any

Example:

Internal server error, contact administrator

GET /acquisitions-units/units/{id}

Retrieve unit item with given {unitId}

GET /acquisitions-units/units/{id}

URI Parameters

id: required (string - pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$)
The UUID of an acquisitions unit

Query Parameters

lang: (string - default: en - pattern: [a-zA-Z]{2})
Requested language. Optional. [lang=en]

Response 200

Returns item with a given ID

Body

Media type: application/json

Type: json

Content:

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "Acquisitions Units",
  "type": "object",
  "properties": {
    "id": {
      "description": "UUID of this acquisitions unit record",
      "$ref": "../../common/schemas/uuid.json"
    },
    "name": {
      "description": "a name for this acquisitions unit",
      "type": "string"
    },
    "isDeleted": {
      "description": "If true, the record is marked for deletion at some point. This prevents it from being assigned to any record.",
      "type": "boolean",
      "default": false
    },
    "protectCreate": {
      "description": "if true, only members can create records associated with this acq unit.",
      "type": "boolean",
      "default": true
    },
    "protectRead": {
      "description": "if true, only members can read/view records associated with this acq unit.",
      "type": "boolean",
      "default": false
    },
    "protectUpdate": {
      "description": "if true, only members can update records associated with this acq unit.",
      "type": "boolean",
      "default": true
    },
    "protectDelete": {
      "description": "if true, only members can delete records associated with this acq unit.",
      "type": "boolean",
      "default": true
    },
    "metadata": {
      "type": "object",
      "$ref": "../../../raml-util/schemas/metadata.schema",
      "readonly": true
    }
  },
  "additionalProperties": false,
  "required": [
    "name",
    "isDeleted"
  ]
}

Example:

{
  "id": "7ec2ed06-0504-40dc-bc53-7515955ff0cb",
  "name": "main",
  "isDeleted": false,
  "protectCreate": true,
  "protectRead": false,
  "protectUpdate": true,
  "protectDelete": true
}

Response 404

Item with a given ID not found

Body

Media type: text/plain

Type: any

Example:

"unit not found"

Response 500

Internal server error, e.g. due to misconfiguration

Body

Media type: text/plain

Type: any

Example:

internal server error, contact administrator

POST /acquisitions-units/memberships

Create new acquisitions units membership

POST /acquisitions-units/memberships

Query Parameters

lang: (string - default: en - pattern: [a-zA-Z]{2})
Requested language. Optional. [lang=en]

Body

Media type: application/json

Type: json

Content:

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "Relationship between a user and an acquistions Unit",
  "type": "object",
  "properties": {
    "id": {
      "description": "UUID of this membership record",
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
    },
    "userId": {
      "description": "The UUID of the user to associate with the acquisitions unit",
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
    },
    "acquisitionsUnitId": {
      "description": "The acquisition unit the user is a member of",
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
    },
    "metadata": {
      "type": "object",
      "$ref": "../../../raml-util/schemas/metadata.schema",
      "readonly": true
    }
  },
  "additionalProperties": false,
  "required": [
    "userId",
    "acquisitionsUnitId"
  ]
}

Example:

{
   "userId": "6e076ac5-371e-4462-af79-187c54fe70de",
   "acquisitionsUnitId": "57c35c88-625d-4f0e-bc79-d22818d84d1c"
}

Response 201

Returns a newly created item, with server-controlled fields like 'id' populated

Headers

Location: required (string)
URI to the created membership item

Body

Media type: application/json

Type: any

Example:

{
   "userId": "6e076ac5-371e-4462-af79-187c54fe70de",
   "acquisitionsUnitId": "57c35c88-625d-4f0e-bc79-d22818d84d1c"
}

Response 400

Bad request, e.g. malformed request body or query parameter. Details of the error (e.g. name of the parameter or line/character number with malformed data) provided in the response.

Body

Media type: text/plain

Type: any

Example:

"unable to add membership -- malformed JSON at 13:3"

Response 401

Not authorized to perform requested action

Body

Media type: text/plain

Type: any

Example:

unable to create memberships -- unauthorized

Response 422

Validation errors

Body

Media type: application/json

Type: json

Content:

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "A set of errors",
  "type": "object",
  "properties": {
    "errors": {
      "description": "List of errors",
      "id": "errors",
      "type": "array",
      "items": {
        "type": "object",
        "$ref": "error.schema"
      }
    },
    "total_records": {
      "type": "integer"
    }
  }
}

Example:

{
  "errors": [
    {
      "message": "may not be null",
      "type": "1",
      "code": "-1",
      "parameters": [
        {
          "key": "moduleTo",
          "value": "null"
        }
      ]
    }
  ]
}

Response 500

Internal server error, e.g. due to misconfiguration

Body

Media type: text/plain

Type: any

Example:

Internal server error, contact administrator

GET /acquisitions-units/memberships

Get list of acquisitions units memberships

GET /acquisitions-units/memberships

Query Parameters

query: (string)
A query expressed as a CQL string (see dev.folio.org/reference/glossary#cql) using valid searchable fields. The first example below shows the general form of a full CQL query, but those fields might not be relevant in this context.
with valid searchable fields: for example acquisitionsUnitId
Example:
```
(username=="ab*" or personal.firstName=="ab*" or personal.lastName=="ab*") and active=="true" sortby personal.lastName personal.firstName barcode

["acquisitionsUnitId", "57c35c88-625d-4f0e-bc79-d22818d84d1c"]
```
offset: (integer - default: 0 - minimum: 0 - maximum: 2147483647)
Skip over a number of elements by specifying an offset value for the query
Example:
```
0
```
limit: (integer - default: 10 - minimum: 0 - maximum: 2147483647)
Limit the number of elements returned in the response
Example:
```
10
```
lang: (string - default: en - pattern: [a-zA-Z]{2})
Requested language. Optional. [lang=en]

Response 200

Returns a list of membership items

Body

Media type: application/json

Type: json

Content:

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "collection of acquisition unit membership records",
  "type": "object",
  "properties": {
    "acquisitionsUnitMemberships": {
      "description": "collection of acquistitions unit membership records",
      "type": "array",
      "id": "acquisitionsUnitMemberships",
      "items": {
        "type": "object",
        "$ref": "acquisitions_unit_membership.json"
      }
    },
    "totalRecords": {
      "description": "The number of objects contained in this collection",
      "type": "integer"
    }
  },
  "additionalProperties": false,
  "required": [
    "acquisitionsUnitMemberships",
    "totalRecords"
  ]
}

Example:

{
  "acquisitionsUnitMemberships":
    [
     {
        "id": "39982f76-9738-4f49-b3a6-707d1e76853c",
        "userId": "6e076ac5-371e-4462-af79-187c54fe70de",
        "acquisitionsUnitId": "57c35c88-625d-4f0e-bc79-d22818d84d1c"
     },
     {
        "id": "567a6d67-460f-43ab-af28-8c730c9aa4da",
        "userId": "480dba68-ee84-4b9c-a374-7e824fc49227",
        "acquisitionsUnitId": "f6d2cc9d-82ca-437c-a4e6-e5c30323df00"
     },
     {
        "id": "874225ae-e3f5-4666-ae19-b35709ff0ee9",
        "userId": "301883b4-a87b-4fc8-a4c1-e13813db06b0",
        "acquisitionsUnitId": "aa0ec4e1-782f-45f6-a6f3-8e6b6c00599c"
     }
    ],
  "totalRecords": 3
}

Response 400

Bad request, e.g. malformed request body or query parameter. Details of the error (e.g. name of the parameter or line/character number with malformed data) provided in the response.

Body

Media type: text/plain

Type: any

Example:

unable to list memberships -- malformed parameter 'query', syntax error at column 6

Response 401

Not authorized to perform requested action

Body

Media type: text/plain

Type: any

Example:

unable to list memberships -- unauthorized

Response 500

Internal server error, e.g. due to misconfiguration

Body

Media type: text/plain

Type: any

Example:

internal server error, contact administrator

PUT /acquisitions-units/memberships/{id}

Update acquisitions units membership

PUT /acquisitions-units/memberships/{id}

URI Parameters

id: required (string - pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$)
The UUID of an acquisitions units membership

Query Parameters

lang: (string - default: en - pattern: [a-zA-Z]{2})
Requested language. Optional. [lang=en]

Body

Media type: application/json

Type: json

Content:

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "Relationship between a user and an acquistions Unit",
  "type": "object",
  "properties": {
    "id": {
      "description": "UUID of this membership record",
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
    },
    "userId": {
      "description": "The UUID of the user to associate with the acquisitions unit",
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
    },
    "acquisitionsUnitId": {
      "description": "The acquisition unit the user is a member of",
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
    },
    "metadata": {
      "type": "object",
      "$ref": "../../../raml-util/schemas/metadata.schema",
      "readonly": true
    }
  },
  "additionalProperties": false,
  "required": [
    "userId",
    "acquisitionsUnitId"
  ]
}

Example:

{
   "id": "39982f76-9738-4f49-b3a6-707d1e76853c",
   "userId": "6e076ac5-371e-4462-af79-187c54fe70de",
   "acquisitionsUnitId": "57c35c88-625d-4f0e-bc79-d22818d84d1c"
}

Response 204

Item successfully updated

Response 400

Bad request, e.g. malformed request body or query parameter. Details of the error (e.g. name of the parameter or line/character number with malformed data) provided in the response.

Body

Media type: text/plain

Type: any

Example:

"unable to update membership -- malformed JSON at 13:4"

Response 404

Item with a given ID not found

Body

Media type: text/plain

Type: any

Example:

"membership not found"

Response 422

Validation errors

Body

Media type: application/json

Type: json

Content:

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "A set of errors",
  "type": "object",
  "properties": {
    "errors": {
      "description": "List of errors",
      "id": "errors",
      "type": "array",
      "items": {
        "type": "object",
        "$ref": "error.schema"
      }
    },
    "total_records": {
      "type": "integer"
    }
  }
}

Example:

{
  "errors": [
    {
      "message": "may not be null",
      "type": "1",
      "code": "-1",
      "parameters": [
        {
          "key": "moduleTo",
          "value": "null"
        }
      ]
    }
  ]
}

Response 500

Internal server error, e.g. due to misconfiguration

Body

Media type: text/plain

Type: any

Example:

internal server error, contact administrator

GET /acquisitions-units/memberships/{id}

Retrieve membership item with given {membershipId}

GET /acquisitions-units/memberships/{id}

URI Parameters

id: required (string - pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$)
The UUID of an acquisitions units membership

Query Parameters

lang: (string - default: en - pattern: [a-zA-Z]{2})
Requested language. Optional. [lang=en]

Response 200

Returns item with a given ID

Body

Media type: application/json

Type: json

Content:

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "description": "Relationship between a user and an acquistions Unit",
  "type": "object",
  "properties": {
    "id": {
      "description": "UUID of this membership record",
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
    },
    "userId": {
      "description": "The UUID of the user to associate with the acquisitions unit",
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
    },
    "acquisitionsUnitId": {
      "description": "The acquisition unit the user is a member of",
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
    },
    "metadata": {
      "type": "object",
      "$ref": "../../../raml-util/schemas/metadata.schema",
      "readonly": true
    }
  },
  "additionalProperties": false,
  "required": [
    "userId",
    "acquisitionsUnitId"
  ]
}

Example:

{
   "id": "39982f76-9738-4f49-b3a6-707d1e76853c",
   "userId": "6e076ac5-371e-4462-af79-187c54fe70de",
   "acquisitionsUnitId": "57c35c88-625d-4f0e-bc79-d22818d84d1c"
}

Response 404

Item with a given ID not found

Body

Media type: text/plain

Type: any

Example:

"membership not found"

Response 500

Internal server error, e.g. due to misconfiguration

Body

Media type: text/plain

Type: any

Example:

internal server error, contact administrator

DELETE /acquisitions-units/memberships/{id}

Delete membership item with given {membershipId}

DELETE /acquisitions-units/memberships/{id}

URI Parameters

id: required (string - pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$)
The UUID of an acquisitions units membership

Query Parameters

lang: (string - default: en - pattern: [a-zA-Z]{2})
Requested language. Optional. [lang=en]

Response 204

Item deleted successfully

Response 400

Bad request, e.g. malformed request body or query parameter. Details of the error (e.g. name of the parameter or line/character number with malformed data) provided in the response.

Body

Media type: text/plain

Type: any

Example:

"unable to delete membership -- constraint violation"

Response 404

Item with a given ID not found

Body

Media type: text/plain

Type: any

Example:

"membership not found"

Response 500

Internal server error, e.g. due to misconfiguration

Body

Media type: text/plain

Type: any

Example:

Internal server error, contact administrator

Acquisitions units (v1.1)

Table of contents

Acquisitions units

/acquisitions-units

POST /acquisitions-units/units

Query Parameters

Response 201

Headers

Response 400

Response 401

Response 422

Response 500

GET /acquisitions-units/units

Query Parameters

Response 200

Response 400

Response 401

Response 500

PUT /acquisitions-units/units/{id}

URI Parameters

Query Parameters

Response 204

Response 400

Response 404

Response 422

Response 500

DELETE /acquisitions-units/units/{id}

URI Parameters

Query Parameters

Response 204

Response 400

Response 404

Response 500

GET /acquisitions-units/units/{id}

URI Parameters

Query Parameters

Response 200

Response 404

Response 500

POST /acquisitions-units/memberships

Query Parameters

Response 201

Headers

Response 400

Response 401

Response 422

Response 500

GET /acquisitions-units/memberships

Query Parameters

Response 200

Response 400

Response 401

Response 500

PUT /acquisitions-units/memberships/{id}

URI Parameters

Query Parameters

Response 204

Response 400

Response 404

Response 422

Response 500

GET /acquisitions-units/memberships/{id}

URI Parameters

Query Parameters

Response 200

Response 404

Response 500

DELETE /acquisitions-units/memberships/{id}

URI Parameters

Query Parameters

Response 204

Response 400

Response 404

Response 500