Add Attachment
POST
/certificates/{certificateId}/attachments
Adds a file attachment (URL + label) to an existing Certificate. The Certificate and its parent Space must exist, and the Space must be active.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ” certificateId
required
string
Header Parameters
Section titled “Header Parameters ” X-Space-Id
required
string format: uuid
UUID of the target Space (tenant boundary). Validated against user access.
Request Body required
Section titled “Request Body required ”object
url
required
URL of the attachment file
string format: uri
Example
https://storage.example.com/docs/attestato.pdf label
required
Human-readable label for the attachment
string
Example
Certificate PDFResponses
Section titled “ Responses ”object
id
required
Attachment ID
string format: uuid
Example
880e8400-e29b-41d4-a716-446655440000 url
required
File URL
string
Example
https://storage.example.com/docs/certificate.pdf label
required
Human-readable label
string
Example
Certificate PDF createdAt
required
Upload timestamp (ISO 8601)
string
Example
2026-01-15T10:30:00.000ZUnauthorized — missing or invalid JWT
Forbidden — insufficient permissions
Resource not found
Validation failed — invalid input