Skip to main content
POST
/
base
/
{baseId}
/
collaborator
cURL
curl --request POST \
  --url https://app.teable.ai/api/base/%7BbaseId%7D/collaborator \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
  --header 'content-type: application/json' \
  --data '{"collaborators":[{"principalId":"string","principalType":"user"}],"role":"creator"}'

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
baseId
string
required

Body

application/json
​
collaborators
object[]
required
​
role
enum<string>
required
Available options:
creator,
editor,
commenter,
viewer

Response

200

Successful response.

Last modified on March 5, 2026