Get Asset
Return one asset's metadata, its gated dashboard URL, and a short-lived presigned `download_url`. To fetch the bytes locally, call this and then GET download_url immediately — the JSON API never carries the file. The CLI's `agent asset get` wraps exactly that two-step.
Return one asset's metadata, its gated dashboard URL, and a
short-lived presigned download_url.
To fetch the bytes locally, call this and then GET download_url
immediately — the JSON API never carries the file. The CLI's
agent asset get wraps exactly that two-step.
Authorization
HTTPBearer In: header
Path Parameters
Header Parameters
Response Body
application/json
application/json
curl -X GET "https://example.com/v1/assets/string"{ "asset": { "agent_session_id": "string", "content_type": "string", "created_at": "2019-08-24T14:15:22Z", "filename": "string", "id": "string", "size_bytes": 0 }, "download_url": "string", "url": "string"}Create Asset
Persist a file to the platform. v1: PNG images only, base64 in the JSON body, 10 MiB cap. The primary caller is the in-sandbox `agent asset upload` CLI (an agent persisting a screenshot to link on a PR), but all credential types work. Returns the org-membership-gated dashboard URL so callers never hard-code URL shapes.
Delete Asset
Delete an asset. A foreign, missing, or already-deleted id is an indistinguishable 404, so ids can't be enumerated. Sandbox tokens get a 403 (a sandbox token sits next to potentially-untrusted code and must not be able to destroy the customer's assets — uploading is fine, destruction is not); API keys and user tokens may delete.