tebarDocs
GuideDevelopersAPI ReferenceChangelog
Profiles

List profiles

GET
/v1/profiles

Oldest first, so the default profile leads.

Requires the read 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.

Query Parameters

external_id?string
Length1 <= length <= 128
limit?integer
Range1 <= value <= 100
Default50
cursor?string
Lengthlength <= 200

Response Body

A page of profiles.

application/json
  1. response
data*array<>
next_cursor*string|null
Example Request
curl -X GET 'https://api.tebar.app/v1/profiles'
Example Response
{
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "name": "string",
      "external_id": "string",
      "is_default": true,
      "created_at": "2019-08-24T14:15:22Z"
    }
  ],
  "next_cursor": "string"
}

Delete a column DELETE

move_to is required when the column has ideas (409 column_not_empty). The last column cannot be deleted (409 last_column). Requires the write scope.

Create a profile POST

An external_id already in use returns that profile with 200, so the request is safe to repeat. Free plan: 403 plan_required; more than 1,000 profiles: 422 profile_limit. Requires the write scope. Owner key or session only: a profile key gets 403 owner_key_required.