tebarDocs
GuideDevelopersAPI ReferenceChangelog
Profiles

Update a profile

PATCH
/v1/profiles/{id}

external_id null removes it; one used by another profile: 409 external_id_taken.

Requires the write scope. Owner key or session only: a profile key gets 403 owner_key_required.

Authorization

bearer
headerAuthorizationBearer <token>

An API key (tb_live_...) from the dashboard, or an OAuth access token.

Path Parameters

id*string
Formatuuid

Request Body

application/json
  1. body
name?string
Length1 <= length <= 100
external_id?|null

Response Body

The profile.

application/json
  1. response
id*string
Formatuuid
name*string
external_id*|

The client's id in your own system.

is_default*boolean
created_at*string
Formatdate-time
Example Request
curl -X PATCH 'https://api.tebar.app/v1/profiles/497f6eca-6276-4993-bfeb-53cbbbba6f08' \
  -H 'Content-Type: application/json' \
  -d '{}'
Example Response
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "external_id": "string",
  "is_default": true,
  "created_at": "2019-08-24T14:15:22Z"
}

Get a profile GET

Requires the read scope. Owner key or session only: a profile key gets 403 owner_key_required.

Delete a profile DELETE

The profile disappears right away; its keys, MCP tokens, and connect links stop working, its accounts are disconnected, and waiting posts are canceled. The rest is removed in the background, then a profile.deleted webhook is sent. The default profile cannot be deleted. Requires the write scope. Owner key or session only: a profile key gets 403 owner_key_required.