Skip to main content
POST
Prepare an agent-owned in-app image upload

Authorizations

Authorization
string
header
required

Opaque user-bound ca_ account credential. Each request checks live account scopes, verified email, expiry, revocation and the issuer session. Not a workspace ck_ key or OAuth access token.

Path Parameters

workspaceId
string
required
Minimum string length: 1
agentId
string
required
Minimum string length: 1

Body

application/json
filename
string
required
Required string length: 1 - 255
contentType
string
required
Required string length: 1 - 255
sizeBytes
integer
required
Required range: x <= 9007199254740991
nudgeId
string
Required string length: 1 - 128

Response

Prepare an agent-owned in-app image upload

key
string
required
Minimum string length: 1
putUrl
string<uri>
required
headers
object
required