attachments
10 endpoints
get /attachments/{id}
Download an attachment
Requires authentication
Streams the attachment bytes (Content-Disposition: attachment). Org-scoped.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | integer | yes | Attachment id |
Responses
- 200 OK · string (binary)
- 401 Unauthorized · apimodel.ErrorEnvelope
- 404 Not Found · apimodel.ErrorEnvelope
delete /attachments/{id}
Delete an attachment
Requires authentication
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | integer | yes | Attachment id |
Responses
- 200 OK · object
- 401 Unauthorized · apimodel.ErrorEnvelope
- 404 Not Found · apimodel.ErrorEnvelope
get /attachments/{id}/signed-url
Get a signed attachment URL
Requires authentication
Mints a short-lived (15 min) HMAC-signed URL the browser can use as an <img> src or a plain link.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | integer | yes | Attachment id |
Responses
- 200 OK · object
- 401 Unauthorized · apimodel.ErrorEnvelope
- 404 Not Found · apimodel.ErrorEnvelope
get /attachments/{id}/view
View a signed attachment
No authentication
Streams the attachment inline when a valid HMAC token + expiry are presented. Public (token is the credential).
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | integer | yes | Attachment id |
| token | query | string | yes | HMAC signature from the signed-url endpoint |
| exp | query | integer | yes | Unix-seconds expiry the token was signed for |
Responses
- 200 OK · string (binary)
- 401 Unauthorized · apimodel.ErrorEnvelope
- 404 Not Found · apimodel.ErrorEnvelope
get /bugs/{id}/attachments
List a bug's attachments
Requires authentication
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | integer | yes | Bug id |
Responses
- 200 OK · object
- 401 Unauthorized · apimodel.ErrorEnvelope
post /bugs/{id}/attachments
Upload an attachment to a bug
Requires authentication
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | integer | yes | Bug id |
Request body: object
| Name | Type | Required | Description |
|---|---|---|---|
| file | string (binary) | yes | File to upload |
Responses
- 201 Created · object
- 400 Bad Request · apimodel.ErrorEnvelope
- 401 Unauthorized · apimodel.ErrorEnvelope
get /changes/{id}/attachments
List a change's attachments
Requires authentication
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | integer | yes | Change (task) id |
Responses
- 200 OK · object
- 401 Unauthorized · apimodel.ErrorEnvelope
post /changes/{id}/attachments
Upload an attachment to a change
Requires authentication
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | integer | yes | Change (task) id |
Request body: object
| Name | Type | Required | Description |
|---|---|---|---|
| file | string (binary) | yes | File to upload |
Responses
- 201 Created · object
- 400 Bad Request · apimodel.ErrorEnvelope
- 401 Unauthorized · apimodel.ErrorEnvelope
get /features/{id}/attachments
List a feature's attachments
Requires authentication
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | integer | yes | Feature id |
Responses
- 200 OK · object
- 401 Unauthorized · apimodel.ErrorEnvelope
post /features/{id}/attachments
Upload an attachment to a feature
Requires authentication
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | integer | yes | Feature id |
Request body: object
| Name | Type | Required | Description |
|---|---|---|---|
| file | string (binary) | yes | File to upload |
Responses
- 201 Created · object
- 400 Bad Request · apimodel.ErrorEnvelope
- 401 Unauthorized · apimodel.ErrorEnvelope