Skip to main content
POST
/
v1
/
contexts
Create a Context
curl --request POST \
  --url https://api.browserbase.com/v1/contexts \
  --header 'Content-Type: application/json' \
  --header 'X-BB-API-Key: <api-key>' \
  --data '
{
  "projectId": "<string>"
}
'
{
  "id": "<string>",
  "uploadUrl": "<string>",
  "publicKey": "<string>",
  "cipherAlgorithm": "<string>",
  "initializationVectorSize": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.browserbase.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-BB-API-Key
string
header
required

Your Browserbase API Key.

Body

application/json
​
projectId
string

The Project ID. Can be found in Settings. Optional - if not provided, the project will be inferred from the API key.

Response

201 - application/json

The request has succeeded and a new resource has been created as a result.

​
id
string
required
​
uploadUrl
string
required

An upload URL to upload a custom user-data-directory.

Minimum string length: 1
​
publicKey
string
required

The public key to encrypt the user-data-directory.

​
cipherAlgorithm
string
required

The cipher algorithm used to encrypt the user-data-directory. AES-256-CBC is currently the only supported algorithm.

​
initializationVectorSize
integer<uint8>
required

The initialization vector size used to encrypt the user-data-directory. Read more about how to use it.