Service Modules > Scheduling and Optimization > Service Board > Max Platform Configuration > Max Platform for Developers > Appendix B: Max REST API > REST API Version 2: Attachments > Get Attachments for Multiple Records
Get Attachments for Multiple Records
Method
GET
URL
/v2/<object_full_identifier>/attachments
Parameters
uuids: comma-separated list of record UUIDs for which to retrieve related attachments
Response Content Type
application/json
Imput Example
Following is an example that shows how to get attachments from two Showcase records by using the uuids parameter. The input should be a GET request with the following URL:
GET https://localhost:8080/v2/io_showcase/attachments?uuids=42f64596-c42f-4ba2-8138-cc40188d2a88,41f19ff6-2738-4000-8bfd-a18950caa1d1
Response Example
The response is a JSON map keyed by record UUIDs, in which each value is an array that represents a record's related attachments, with URLs that honor HATEOAS. In the following example Status Code 200 response, the record with UUID 42f64596-c42f-4ba2-8138-cc40188d2a88 has no attachments and is represented by an empty array, and the record with UUID 41f19ff6-2738-4000-8bfd-a18950caa1d1 has multiple attachments.
{
"42f64596-c42f-4ba2-8138-cc40188d2a88": [],  
"41f19ff6-2738-4000-8bfd-a18950caa1d1":
    [{
         "updated_on":"1480085367917",
         "size":"314",
         "media_type":"application/rtf",
         "version_uuid":"28d28b95-277e-4d8b-98c7-0777b4d810c5",
         "name":"file1.txt",
         "links":[
            {    "rel":"url",
                "href":"https://localhost:8080/document/e74f0eff-ed37-4d72-9410-01977c5199e5/latest?148008536791"
            }
             {    "rel":"thumbnail_url",
                "href":"https://localhost:8080/document/3b156bad-81fd-4c86-9624-50c4f7cdb71d/latest?5.0.0.620-SNAPSHOT"
            }],
          "type":"file",
          "uuid":"e74f0eff-ed37-4d72-9410-01977c5199e5"
    },
    {
          "updated_on":"1480085367917",
          "size":"310",
          "media_type":"application/rtf",
          "version_uuid":"71e5b04f-3f41-480d-8a71-74fcb28f1600",
          "name":"file2.text",
          "links":[
            {    "rel":"url",
                "href":"https://localhost:8080/document/ef39b3db-01ce-4a72-aa28-f3af91917245/latest?1480085367917"
            }    
            {    "rel":"thumbnail_url",
                "href":"https://localhost:8080/document/3b156bad-81fd-4c86-9624-50c4f7cdb71d/latest?5.0.0.620-SNAPSHOT"
            }],
          "type":"file",
          "uuid":"ef39b3db-01ce-4a72-aa28-f3af91917245"
    }, ...]
}
Input Example
Following is an example of how to retrieve all Showcase records that have at least one attachment. If no records have attachments, the response is an empty map. The input should be a GET request with the following URL:
GET https://localhost:8080/v2/io_showcase/attachments
Response Example
The response format is the same as that for Get Attachments for Single Records when you use the uuids parameter.
Error Response Messages
HTTP Status Code
Error Message
400
 
The object identifier is not specified or is invalid
The uuids parameter contains an invalid UUID
404
 
Any of the records specified on the uuids parameters, to get attachments from, was not found (or user has no permission to access it)
500
 
 Internal Server error
Was this helpful?