Attachments as a Service API (1.0.0)
Download OpenAPI specification:Download
Attachment Management API for Equinix Customer Portal
Upload a Multipart File
This method can be used to upload an attachment as a multipart file.
query Parameters
purpose | string Enum: "LOA" "PO_DOCUMENT" Purpose of the file is uploaded. [ ex. LOA is for Cross connect, PO is for Purchar order ] |
header Parameters
Authorization required | string >= 1 Specify the Access token with prefix 'Bearer '. |
Request Body schema: multipart/form-datarequired
uploadFile required | string <binary> The file to be uploaded |
Responses
Response Schema: application/json
attachmentId required | string <uuid> Unique Identifier for the attachment |
attachmentName required | string File name of the attachment |
attachmentType required | string Extension of the document |
attachmentSize required | number [ 0 .. 1000000000 ) Default: 0 size of the attachment in bytes |
createdDate required | string <date-time> Created date |
createdBy required | string User key of the author of the attachment |
lastUpdatedDate required | string <date-time> Last accessed date for the record |
Response samples
- 201
- 500
- 503
{- "attachmentId": "56d10de6-f2c0-4edd-ba29-b70736aa2093",
- "attachmentName": "Example_Invoice.xlsx",
- "attachmentType": "xlsx",
- "attachmentSize": 259387,
- "createdDate": "2017-01-31T09:03:08.340Z",
- "createdBy": "john.doe@example.com",
- "lastUpdatedDate": "2017-04-06T17:10:44.807Z"
}
Delete Attachment by Id
This method deletes the attachment with a specific id value.
path Parameters
attachmentId required | string <uuid> The id of the attachment. |
header Parameters
Authorization required | string >= 1 Specify the Access token with prefix 'Bearer '. |
Responses
Response Schema: application/json
status required | boolean Default: false Status message |
Response samples
- 200
- 403
- 404
- 500
- 503
{- "status": true
}
Get Attachment by Id
This method gets the metadata for the attachment file with a specific. attachment id value.
path Parameters
attachmentId required | string <uuid> The id of the attachment. |
header Parameters
Authorization required | string >= 1 Specify the Access token with prefix 'Bearer '. |
Responses
Response Schema: application/json
attachmentId required | string <uuid> Unique Identifier for the attachment |
attachmentName required | string File name of the attachment |
attachmentType required | string Extension of the document |
attachmentSize required | number [ 0 .. 1000000000 ) Default: 0 size of the attachment in bytes |
createdDate required | string <date-time> Created date |
createdBy required | string User key of the author of the attachment |
lastUpdatedDate required | string <date-time> Last accessed date for the record |
Response samples
- 200
- 403
- 404
- 500
- 503
{- "attachmentId": "56d10de6-f2c0-4edd-ba29-b70736aa2093",
- "attachmentName": "Example_Invoice.pdf",
- "attachmentType": "application/pdf",
- "attachmentSize": 259387,
- "createdDate": "2017-01-31T09:03:08.340Z",
- "createdBy": "john.doe@example.com",
- "lastUpdatedDate": "2017-04-06T17:10:44.807Z"
}
Download Attachment File
This method gets the binary file attachment with a specific attachment id value.
path Parameters
attachmentId required | string <uuid> The id of the attachment record you want to get binary data from. |
header Parameters
Authorization required | string >= 1 Specify the Access token with prefix 'Bearer '. |
Responses
Response samples
- 403
- 404
- 500
- 503
Get List of Attachments
This method gets the metadata for multiple attachments. The response is paginated and will output limited number of records per page.
query Parameters
offset | integer >= 0 Default: 0 Page number to skip the results |
limit | integer [ 0 .. 100 ] Default: 20 Number of expected records in the response |
attachmentIds | Array of strings non-empty unique Comma separated attachment ids to search |
header Parameters
Authorization required | string >= 1 Specify the Access token with prefix 'Bearer '. |
Responses
Response Schema: application/json
required | Array of objects (Attachment) >= 0 items List of records | ||||||||||||||||||||||||||||||
Array (>= 0 items)
| |||||||||||||||||||||||||||||||
object (Page) | |||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||
required | object (Links) | ||||||||||||||||||||||||||||||
|
Response samples
- 200
- 500
- 503
{- "data": [
- {
- "attachmentId": "56d10de6-f2c0-4edd-ba29-b70736aa2093",
- "attachmentName": "Example_Invoice.xlsx",
- "attachmentType": "xlsx",
- "attachmentSize": 259387,
- "createdDate": "2017-01-31T09:03:08.340Z",
- "createdBy": "john.doe@example.com",
- "lastUpdatedDate": "2017-04-06T17:10:44.807Z"
}, - {
- "attachmentId": "56d10de6-f2c0-4edd-ba29-b70736aa2093",
- "attachmentName": "Example_Invoice.xlsx",
- "attachmentType": "xlsx",
- "attachmentSize": 259387,
- "createdDate": "2017-01-31T09:03:08.340Z",
- "createdBy": "john.doe@example.com",
- "lastUpdatedDate": "2017-04-06T17:10:44.807Z"
}
], - "page": {
- "total": 100,
- "limit": 10,
- "offset": 0,
- "sorts": [
- "-createdDate"
]
}, - "_links": {
- "first": {
- "href": "/attachments?limit=10&offset=0"
}, - "next": {
- "href": "/attachments?limit=10&offset=50"
}, - "self": {
- "href": "/attachments?limit=10&offset=40"
}, - "prev": {
- "href": "/attachments?limit=10&offset=30"
}, - "last": {
- "href": "/attachments?limit=10&offset=100"
}
}
}