Skip to content
Management API Reference

[Alpha] Mint a presigned slot for a build-context upload

post/v2/projects/{ref}/workers/{name}/uploads

PUT the .tar.gz build context to the returned url before expires_at, then deploy with the upload id as context_upload_id. The bytes go straight to storage — no management API request carries them.

OAuth scopes

  • edge_functions:write

The fine-grained token must include the following permissions to access this endpoint:

  • workers_write

Path parameters

  • ref
    Required
    string

    Project ref

  • name
    Required
    string

Response codes

  • 201
  • 401
  • 403
  • 429

Response (201)

{
  "data": {
    "type": "project_worker_upload",
    "id": "cafe0000000000000000000000000000",
    "attributes": {
      "url": "lorem",
      "method": "PUT",
      "expires_at": "lorem"
    }
  }
}