Invite member
Invite an email address to the workspace at a role (default editor). Roles: admin can do everything including members and billing; editor builds and tests agents; viewer sees agents and calls but changes nothing; reader sees calls and insights in the portal only. Sends the invitation email and returns the invite link; someone who already has an account is added straight away and told by email. Pass agentIds to limit them to specific agents: a limited person sees only those agents and does not use a seat. Refused at the seat limit and for someone already a member. Making someone an owner is not possible here.
Authorization
bearerAuth A personal access token from Settings > API tokens.
In: header
Header Parameters
A key you choose, such as a UUID, that makes this POST safe to retry. Within 24 hours the same key and request answers with the first successful answer and runs nothing, the same key with a different request answers 422 idempotency_key_reused, and a key whose request is still running answers 409 idempotency_key_in_use. A failed request keeps nothing, so the same key runs it again.
1 <= length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/operations/invite_member" \ -H "Content-Type: application/json" \ -d '{ "workspace": "string", "email": "string" }'{}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}Connect an app POST
Begin connecting an app for THIS agent and return an authorization link the operator opens to finish. The agent gets its OWN dedicated account for the app, so two agents can connect two distinct accounts of the same app. Returns `{ redirectUrl, connectionId, status: 'pending' }`, relay the redirectUrl to the operator; the connection flips to 'active' once they authorize (poll with list_agent_connections). Once active the agent loads the app's recommended tools automatically; narrow them later with set_agent_connection. One-click and bring-your-own-key apps connect through here; apps that require the operator's own OAuth-app credentials are refused with a message pointing to Connected apps in the app, which collects them (secrets never pass through this op). Requires workspace-admin.
List my access tokens POST
List your own personal access tokens: name, the first characters of the token, read or write access, the workspace it is pinned to, and when it was created, expires, was last used, or was revoked. The token values themselves are never shown. Making or revoking a token is only possible in Settings → API tokens. Refused when this connection itself uses an access token.