POST
/v1/browser/activateActivate browser key
Use this from browser integrations before creating jobs. Send the publishable key in the JSON body; the API validates the Origin header against the key's allowed-origins list.
Publishable key flowNo Authorization header; publishable key in JSON body with allowed OriginSandbox this
Request parameters
| Name | Type | Required | Description |
|---|---|---|---|
| publishable_key | string | Required | Publishable key shown once in the dashboard. |
| Origin header | string | Required | Browser origin that must match an allowed origin for the publishable key. |
Returns
| Name | Type | Description |
|---|---|---|
| ok | boolean | True when activation succeeds. |
| activation_token | string | Short-lived token bound to the project and origin. |
| expires_at_ms | integer | Unix epoch milliseconds for token expiry. |
| key_id | string | Activated publishable key identifier. |
| wrapper_tenant_id | string | Wrapper tenant bound to the token. |
| project_id | string | Project bound to the token. |
Request example
POST /v1/browser/activate
activate.shbash
1curl -X POST https://api.wavebird.ai/v1/browser/activate \2 -H "Origin: https://publisher.example" \3 -H "Content-Type: application/json" \4 -d '{5 "publishable_key": "pk_test_wavebird_demo_publishable"6 }'Response example
Response
response.jsonjson
1{2 "ok": true,3 "activation_token": "wbat_demo_eyJhbGciOi...",4 "expires_at_ms": 1777032600000,5 "key_id": "key_demo_123",6 "wrapper_tenant_id": "wbt_demo_123",7 "project_id": "wbproj_demo_8jK42"8}Errors
unauthorized401Missing or unknown publishable key.
forbidden403Origin is not allowed for this key.
validation_error400publishable_key is missing or malformed, or the Origin header is absent.