Overview
GET/storage/uploads/{id}storage

Get one of the caller's attachments by id

Fetch a record from uploads by id.

Auth: bearerAuth — calls run as the authenticated user.

Parameters
  • idpathstring
Responses
200

Attachment

  • idstring
  • ecosystemIdstring
  • customerIdstring
  • ownerTypestring

    e.g. 'standalone', 'chat_message', 'document'

  • ownerIdoptionalstring?

    Polymorphic domain owner (NOT the tenant).

  • objectKeystring

    R2 object key the presigned URLs address.

  • storageKindstring

    Backing store, e.g. 'r2'.

  • filenamestring
  • contentTypestring
  • sizeBytesinteger
  • contentHashstring
  • widthoptionalinteger?
  • heightoptionalinteger?
  • durationMsoptionalinteger?
  • status"pending" | "ready"

    'pending' (presigned, awaiting upload) → 'ready' (bytes confirmed).

  • metadataoptionalobject?

    Caller-supplied JSON metadata (jsonb) — intentionally open.

  • createdAtstring
  • updatedAtstring
  • deletedAtoptionalstring?
Example
{
  "id": "string",
  "ecosystemId": "string",
  "customerId": "string",
  "ownerType": "string",
  "ownerId": "string",
  "objectKey": "string",
  "storageKind": "string",
  "filename": "string",
  "contentType": "string",
  "sizeBytes": 0,
  "contentHash": "string",
  "width": 0,
  "height": 0,
  "durationMs": 0,
  "status": "pending",
  "metadata": {},
  "createdAt": "string",
  "updatedAt": "string",
  "deletedAt": "string"
}
401

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
404

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
Code examples
cURL
curl -X GET "https://api.agenticdeveloperhub.com/storage/uploads/{id}" \
  -H "Authorization: Bearer YOUR_TOKEN"
JavaScript
const res = await fetch("https://api.agenticdeveloperhub.com/storage/uploads/{id}", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  },
});
const data = await res.json();