Assets · API · Axiom Lab

List Assets

GET/v1/assets

API key requiredSuccess 200

Parameters

Name	Type	Description
`limit`query	integer	Default `50`; range 1–200
`cursor`query	string	length ≤ 256; nullable
`after`query	string	length ≤ 256; nullable
`X-Project-ID`header	string	The project to act on; the default project when omitted; nullable

Response 200 application/json

Name	Type	Description
`data`required	array<object>
`data[].id`required	string
`data[].project_id`required	string	nullable
`data[].filename`required	string
`data[].bytes`required	integer
`data[].sha256`required	string
`data[].created_at`required	number
`next_cursor`	string	Opaque; pass as `cursor` (or the `after` alias) for the next page; nullable
`has_more`	boolean	Default `false`

Example

curl "https://axiomlab.online/v1/assets" \
  -H "Authorization: Bearer $AZIMO_API_KEY"

Upload Asset

POST/v1/assets

API key requiredSuccess 201

Parameters

Name	Type	Description
`Idempotency-Key`header	string	A unique value you generate and keep; reuse it when retrying so the request never runs twice; length 1–128; nullable
`X-Project-ID`header	string	The project to act on; the default project when omitted; nullable

Request body multipart/form-data

Name	Type	Description
`file`required	file

Response 201 application/json

Name	Type	Description
`id`required	string
`project_id`required	string	nullable
`filename`required	string
`bytes`required	integer
`sha256`required	string
`created_at`required	number

Example

curl -X POST "https://axiomlab.online/v1/assets" \
  -H "Authorization: Bearer $AZIMO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -F "file=@deck.pdf"

Get Asset

GET/v1/assets/{asset_id}

API key requiredSuccess 200

Parameters

Name	Type	Description
`asset_id`requiredpath	string
`X-Project-ID`header	string	The project to act on; the default project when omitted; nullable

Response 200 application/json

Name	Type	Description
`id`required	string
`project_id`required	string	nullable
`filename`required	string
`bytes`required	integer
`sha256`required	string
`created_at`required	number

Example

curl "https://axiomlab.online/v1/assets/<asset_id>" \
  -H "Authorization: Bearer $AZIMO_API_KEY"

Delete Asset

DELETE/v1/assets/{asset_id}

API key requiredSuccess 200

Remove an upload and its bytes. Jobs that already consumed it keep their own copies.

Parameters

Name	Type	Description
`asset_id`requiredpath	string
`X-Project-ID`header	string	The project to act on; the default project when omitted; nullable

Response 200 application/json

Name	Type	Description
`id`required	string
`deleted`	boolean	Default `true`

Example

curl -X DELETE "https://axiomlab.online/v1/assets/<asset_id>" \
  -H "Authorization: Bearer $AZIMO_API_KEY"

Download Asset

GET/v1/assets/{asset_id}/file

API key requiredSuccess 200

Parameters

Name	Type	Description
`asset_id`requiredpath	string
`X-Project-ID`header	string	The project to act on; the default project when omitted; nullable

Response 200 application/octet-stream

Returns the file bytes.

Example

curl "https://axiomlab.online/v1/assets/<asset_id>/file" \
  -H "Authorization: Bearer $AZIMO_API_KEY"