uploadCaptureAsset

PUT

/captures/{captureId}/assets/{assetKey}

curl --request PUT \
  --url http://localhost:8080/api/v1/captures/per_01j9x3k8m2q4r5s6t7v8w9y0z1/assets/example \
  --header 'Content-Type: application/octet-stream' \
  --cookie hs_session=<hs_session> \
  --data example

• Your Homestead (default port; replace with your address)

Called by Homestead Helper with the capture’s upload token (Bearer hsu_…), which is valid for 10 minutes and only for this capture’s listed assets. Body is the cached response body. Max 50 MB; image/* or video/* only.

Authorizations

• cookieAuth
• bearerAuth

Parameters

Path Parameters

captureId

required

string

/^[a-z]{2,3}_[0-9a-hjkmnp-tv-z]{26}$/

assetKey

required

SHA-1 hex of the asset URL.

string

/^[0-9a-f]{40}$/

Request Body^required

Media typeapplication/octet-stream

string

Responses

204

Stored (or already present).

401

Missing or invalid credentials.

Media typeapplication/problem+json

object

type

required

string format: uri

title

required

string

status

required

integer

code

required

string

i18nKey

string

detail

string

fields

Array<object>

object

path

required

string

code

required

string

i18nKey

string

Example ^generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "code": "example",
  "i18nKey": "example",
  "detail": "example",
  "fields": [
    {
      "path": "example",
      "code": "example",
      "i18nKey": "example"
    }
  ]
}

404

Not found.

Media typeapplication/problem+json

object

type

required

string format: uri

title

required

string

status

required

integer

code

required

string

i18nKey

string

detail

string

fields

Array<object>

object

path

required

string

code

required

string

i18nKey

string

Example ^generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "code": "example",
  "i18nKey": "example",
  "detail": "example",
  "fields": [
    {
      "path": "example",
      "code": "example",
      "i18nKey": "example"
    }
  ]
}

413

Too large.

Media typeapplication/problem+json

object

type

required

string format: uri

title

required

string

status

required

integer

code

required

string

i18nKey

string

detail

string

fields

Array<object>

object

path

required

string

code

required

string

i18nKey

string

Example ^generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "code": "example",
  "i18nKey": "example",
  "detail": "example",
  "fields": [
    {
      "path": "example",
      "code": "example",
      "i18nKey": "example"
    }
  ]
}