Worbo API

curl "https://api.worbo.app/v1/me" \
  -H "Authorization: Bearer $WORBO_API_KEY"

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.worbo.app/v1/me', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/me', {
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
  },
});

const data = await response.json();

import os

import requests

response = requests.get(
    "https://api.worbo.app/v1/me",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
    },
)

data = response.json()

{
  "data": {
    "key": {
      "name": "CRM",
      "environment": "live",
      "scopes": [
        "string"
      ],
      "expires_at": "2026-10-15T09:00:00+03:00",
      "api_version": "2026-10-05"
    },
    "organization": {
      "name": "Sala Centru",
      "slug": "sala-centru"
    },
    "api_version": "2026-10-05"
  }
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl "https://api.worbo.app/v1/numbers" \
  -H "Authorization: Bearer $WORBO_API_KEY"

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.worbo.app/v1/numbers', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/numbers', {
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
  },
});

const data = await response.json();

import os

import requests

response = requests.get(
    "https://api.worbo.app/v1/numbers",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
    },
)

data = response.json()

{
  "data": [
    {
      "id": 3,
      "phone": "+40 722 000 000",
      "name": "Sala Centru",
      "sandbox": false,
      "quality_rating": "GREEN",
      "messaging_limit_tier": "TIER_1K",
      "warmup": false,
      "marketing_paused_until": "2026-10-15T09:00:00+03:00",
      "disabled": false,
      "disabled_reason": "string"
    }
  ]
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl "https://api.worbo.app/v1/usage" \
  -H "Authorization: Bearer $WORBO_API_KEY"

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.worbo.app/v1/usage', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/usage', {
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
  },
});

const data = await response.json();

import os

import requests

response = requests.get(
    "https://api.worbo.app/v1/usage",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
    },
)

data = response.json()

{
  "data": {
    "month": "2026-10",
    "currency": "EUR",
    "categories": {
      "marketing": {
        "messages": 120,
        "billable": 118,
        "estimated_cost": 6.42
      }
    },
    "estimated_cost": 6.42,
    "plan": "growth",
    "billing_state": "active",
    "limits": {}
  }
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/validation_failed",
  "title": "Cererea nu este validă",
  "status": 422,
  "detail": "Un parametru lipsește, nu e valid sau nu e cunoscut; câmpul errors spune care.",
  "code": "validation_failed"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl "https://api.worbo.app/v1/audit-logs" \
  -H "Authorization: Bearer $WORBO_API_KEY"

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.worbo.app/v1/audit-logs', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/audit-logs', {
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
  },
});

const data = await response.json();

import os

import requests

response = requests.get(
    "https://api.worbo.app/v1/audit-logs",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
    },
)

data = response.json()

{
  "data": [
    {
      "id": 1201,
      "action": "contact.created",
      "label": "Contact created",
      "source": "api",
      "actor": {},
      "subject": {},
      "properties": {},
      "created_at": "2026-10-15T09:00:00+03:00"
    }
  ],
  "next_cursor": "string",
  "has_more": true
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/validation_failed",
  "title": "Cererea nu este validă",
  "status": 422,
  "detail": "Un parametru lipsește, nu e valid sau nu e cunoscut; câmpul errors spune care.",
  "code": "validation_failed"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl "https://api.worbo.app/v1/contacts" \
  -H "Authorization: Bearer $WORBO_API_KEY"

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.worbo.app/v1/contacts', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/contacts', {
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
  },
});

const data = await response.json();

import os

import requests

response = requests.get(
    "https://api.worbo.app/v1/contacts",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
    },
)

data = response.json()

{
  "data": [
    {
      "id": 123,
      "identities": [
        {
          "id": 501,
          "type": "phone",
          "value": "+40722123456",
          "source": "string",
          "primary": true
        }
      ],
      "fields": {
        "first_name": "Ana",
        "last_name": "Popescu",
        "language": "ro"
      },
      "tags": [
        "vip"
      ],
      "source": "api",
      "blocked": false,
      "created_at": "2026-10-15T09:00:00+03:00",
      "updated_at": "2026-10-15T09:00:00+03:00"
    }
  ],
  "next_cursor": "string",
  "has_more": true
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/validation_failed",
  "title": "Cererea nu este validă",
  "status": 422,
  "detail": "Un parametru lipsește, nu e valid sau nu e cunoscut; câmpul errors spune care.",
  "code": "validation_failed"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl -X POST "https://api.worbo.app/v1/contacts" \
  -H "Authorization: Bearer $WORBO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "identities": {
      "phone": "+40722123456",
      "email": "ana@example.com",
      "external_id": "crm-1001"
    },
    "source": "crm",
    "fields": {
      "first_name": "Ana"
    },
    "update_existing_only": false
  }'

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.worbo.app/v1/contacts', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
        'Idempotency-Key' => bin2hex(random_bytes(16)),
    ],
    'json' => [
        'identities' => [
            'phone' => '+40722123456',
            'email' => 'ana@example.com',
            'external_id' => 'crm-1001',
        ],
        'source' => 'crm',
        'fields' => [
            'first_name' => 'Ana',
        ],
        'update_existing_only' => false,
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/contacts', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "identities": {
      "phone": "+40722123456",
      "email": "ana@example.com",
      "external_id": "crm-1001",
    },
    "source": "crm",
    "fields": {
      "first_name": "Ana",
    },
    "update_existing_only": false,
  }),
});

const data = await response.json();

import os
import uuid

import requests

response = requests.post(
    "https://api.worbo.app/v1/contacts",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "identities": {
            "phone": "+40722123456",
            "email": "ana@example.com",
            "external_id": "crm-1001",
        },
        "source": "crm",
        "fields": {
            "first_name": "Ana",
        },
        "update_existing_only": False,
    },
)

data = response.json()

{
  "data": {
    "id": 123,
    "identities": [
      {
        "id": 501,
        "type": "phone",
        "value": "+40722123456",
        "source": "string",
        "primary": true
      }
    ],
    "fields": {
      "first_name": "Ana",
      "last_name": "Popescu",
      "language": "ro"
    },
    "tags": [
      "vip"
    ],
    "source": "api",
    "blocked": false,
    "created_at": "2026-10-15T09:00:00+03:00",
    "updated_at": "2026-10-15T09:00:00+03:00"
  }
}

{
  "data": {
    "id": 123,
    "identities": [
      {
        "id": 501,
        "type": "phone",
        "value": "+40722123456",
        "source": "string",
        "primary": true
      }
    ],
    "fields": {
      "first_name": "Ana",
      "last_name": "Popescu",
      "language": "ro"
    },
    "tags": [
      "vip"
    ],
    "source": "api",
    "blocked": false,
    "created_at": "2026-10-15T09:00:00+03:00",
    "updated_at": "2026-10-15T09:00:00+03:00"
  }
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/idempotency_conflict",
  "title": "Idempotency-Key a fost folosită pentru altă cerere",
  "status": 409,
  "detail": "Idempotency-Key a fost folosit pentru altă cerere.",
  "code": "idempotency_conflict"
}

{
  "type": "https://worbo.app/docs/api/errors/validation_failed",
  "title": "Cererea nu este validă",
  "status": 422,
  "detail": "Un parametru lipsește, nu e valid sau nu e cunoscut; câmpul errors spune care.",
  "code": "validation_failed"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl -X POST "https://api.worbo.app/v1/contacts/batch" \
  -H "Authorization: Bearer $WORBO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "identities": {
          "phone": "+40722123456",
          "email": "ana@example.com",
          "external_id": "crm-1001"
        },
        "source": "crm",
        "fields": {
          "first_name": "Ana"
        },
        "update_existing_only": false
      }
    ]
  }'

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.worbo.app/v1/contacts/batch', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
        'Idempotency-Key' => bin2hex(random_bytes(16)),
    ],
    'json' => [
        'items' => [
            [
                'identities' => [
                    'phone' => '+40722123456',
                    'email' => 'ana@example.com',
                    'external_id' => 'crm-1001',
                ],
                'source' => 'crm',
                'fields' => [
                    'first_name' => 'Ana',
                ],
                'update_existing_only' => false,
            ],
        ],
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/contacts/batch', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "items": [
      {
        "identities": {
          "phone": "+40722123456",
          "email": "ana@example.com",
          "external_id": "crm-1001",
        },
        "source": "crm",
        "fields": {
          "first_name": "Ana",
        },
        "update_existing_only": false,
      },
    ],
  }),
});

const data = await response.json();

import os
import uuid

import requests

response = requests.post(
    "https://api.worbo.app/v1/contacts/batch",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "items": [
            {
                "identities": {
                    "phone": "+40722123456",
                    "email": "ana@example.com",
                    "external_id": "crm-1001",
                },
                "source": "crm",
                "fields": {
                    "first_name": "Ana",
                },
                "update_existing_only": False,
            },
        ],
    },
)

data = response.json()

{
  "data": [
    {
      "index": 0,
      "status": "created",
      "data": {
        "id": 123,
        "identities": [
          {
            "id": 501,
            "type": "phone",
            "value": "+40722123456",
            "source": "string",
            "primary": true
          }
        ],
        "fields": {
          "first_name": "Ana",
          "last_name": "Popescu",
          "language": "ro"
        },
        "tags": [
          "vip"
        ],
        "source": "api",
        "blocked": false,
        "created_at": "2026-10-15T09:00:00+03:00",
        "updated_at": "2026-10-15T09:00:00+03:00"
      },
      "error": {
        "type": "https://worbo.app/docs/api/errors/validation_failed",
        "title": "The request is not valid",
        "status": 422,
        "detail": "The name field is required.",
        "code": "validation_failed",
        "errors": {
          "name": [
            "The name field is required."
          ]
        }
      }
    }
  ]
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/idempotency_conflict",
  "title": "Idempotency-Key a fost folosită pentru altă cerere",
  "status": 409,
  "detail": "Idempotency-Key a fost folosit pentru altă cerere.",
  "code": "idempotency_conflict"
}

{
  "type": "https://worbo.app/docs/api/errors/validation_failed",
  "title": "Cererea nu este validă",
  "status": 422,
  "detail": "Un parametru lipsește, nu e valid sau nu e cunoscut; câmpul errors spune care.",
  "code": "validation_failed"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl "https://api.worbo.app/v1/contacts/123" \
  -H "Authorization: Bearer $WORBO_API_KEY"

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.worbo.app/v1/contacts/123', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/contacts/123', {
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
  },
});

const data = await response.json();

import os

import requests

response = requests.get(
    "https://api.worbo.app/v1/contacts/123",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
    },
)

data = response.json()

{
  "data": {
    "id": 123,
    "identities": [
      {
        "id": 501,
        "type": "phone",
        "value": "+40722123456",
        "source": "string",
        "primary": true
      }
    ],
    "fields": {
      "first_name": "Ana",
      "last_name": "Popescu",
      "language": "ro"
    },
    "tags": [
      "vip"
    ],
    "source": "api",
    "blocked": false,
    "created_at": "2026-10-15T09:00:00+03:00",
    "updated_at": "2026-10-15T09:00:00+03:00"
  }
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/not_found",
  "title": "Negăsit",
  "status": 404,
  "detail": "Resursa nu există sau aparține altei organizații.",
  "code": "not_found"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl -X PATCH "https://api.worbo.app/v1/contacts/123" \
  -H "Authorization: Bearer $WORBO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fields": {
      "last_name": "Ionescu"
    }
  }'

$client = new \GuzzleHttp\Client();

$response = $client->request('PATCH', 'https://api.worbo.app/v1/contacts/123', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
    ],
    'json' => [
        'fields' => [
            'last_name' => 'Ionescu',
        ],
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/contacts/123', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "fields": {
      "last_name": "Ionescu",
    },
  }),
});

const data = await response.json();

import os

import requests

response = requests.patch(
    "https://api.worbo.app/v1/contacts/123",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
    },
    json={
        "fields": {
            "last_name": "Ionescu",
        },
    },
)

data = response.json()

{
  "data": {
    "id": 123,
    "identities": [
      {
        "id": 501,
        "type": "phone",
        "value": "+40722123456",
        "source": "string",
        "primary": true
      }
    ],
    "fields": {
      "first_name": "Ana",
      "last_name": "Popescu",
      "language": "ro"
    },
    "tags": [
      "vip"
    ],
    "source": "api",
    "blocked": false,
    "created_at": "2026-10-15T09:00:00+03:00",
    "updated_at": "2026-10-15T09:00:00+03:00"
  }
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/not_found",
  "title": "Negăsit",
  "status": 404,
  "detail": "Resursa nu există sau aparține altei organizații.",
  "code": "not_found"
}

{
  "type": "https://worbo.app/docs/api/errors/idempotency_conflict",
  "title": "Idempotency-Key a fost folosită pentru altă cerere",
  "status": 409,
  "detail": "Idempotency-Key a fost folosit pentru altă cerere.",
  "code": "idempotency_conflict"
}

{
  "type": "https://worbo.app/docs/api/errors/validation_failed",
  "title": "Cererea nu este validă",
  "status": 422,
  "detail": "Un parametru lipsește, nu e valid sau nu e cunoscut; câmpul errors spune care.",
  "code": "validation_failed"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl -X DELETE "https://api.worbo.app/v1/contacts/123" \
  -H "Authorization: Bearer $WORBO_API_KEY"

$client = new \GuzzleHttp\Client();

$response = $client->request('DELETE', 'https://api.worbo.app/v1/contacts/123', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
    ],
]);

const response = await fetch('https://api.worbo.app/v1/contacts/123', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
  },
});

import os

import requests

response = requests.delete(
    "https://api.worbo.app/v1/contacts/123",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
    },
)

Fără conținut

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/not_found",
  "title": "Negăsit",
  "status": 404,
  "detail": "Resursa nu există sau aparține altei organizații.",
  "code": "not_found"
}

{
  "type": "https://worbo.app/docs/api/errors/idempotency_conflict",
  "title": "Idempotency-Key a fost folosită pentru altă cerere",
  "status": 409,
  "detail": "Idempotency-Key a fost folosit pentru altă cerere.",
  "code": "idempotency_conflict"
}

{
  "type": "https://worbo.app/docs/api/errors/validation_failed",
  "title": "Cererea nu este validă",
  "status": 422,
  "detail": "Un parametru lipsește, nu e valid sau nu e cunoscut; câmpul errors spune care.",
  "code": "validation_failed"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl -X POST "https://api.worbo.app/v1/contacts/123/bot" \
  -H "Authorization: Bearer $WORBO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": false
  }'

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.worbo.app/v1/contacts/123/bot', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
        'Idempotency-Key' => bin2hex(random_bytes(16)),
    ],
    'json' => [
        'enabled' => false,
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/contacts/123/bot', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "enabled": false,
  }),
});

const data = await response.json();

import os
import uuid

import requests

response = requests.post(
    "https://api.worbo.app/v1/contacts/123/bot",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "enabled": False,
    },
)

data = response.json()

{
  "data": {
    "contact_id": 123,
    "bot_enabled": false
  }
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/not_found",
  "title": "Negăsit",
  "status": 404,
  "detail": "Resursa nu există sau aparține altei organizații.",
  "code": "not_found"
}

{
  "type": "https://worbo.app/docs/api/errors/idempotency_conflict",
  "title": "Idempotency-Key a fost folosită pentru altă cerere",
  "status": 409,
  "detail": "Idempotency-Key a fost folosit pentru altă cerere.",
  "code": "idempotency_conflict"
}

{
  "type": "https://worbo.app/docs/api/errors/validation_failed",
  "title": "Cererea nu este validă",
  "status": 422,
  "detail": "Un parametru lipsește, nu e valid sau nu e cunoscut; câmpul errors spune care.",
  "code": "validation_failed"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl "https://api.worbo.app/v1/contacts/123/identities" \
  -H "Authorization: Bearer $WORBO_API_KEY"

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.worbo.app/v1/contacts/123/identities', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/contacts/123/identities', {
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
  },
});

const data = await response.json();

import os

import requests

response = requests.get(
    "https://api.worbo.app/v1/contacts/123/identities",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
    },
)

data = response.json()

{
  "data": [
    {
      "id": 501,
      "type": "phone",
      "value": "+40722123456",
      "source": "string",
      "primary": true
    }
  ]
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/not_found",
  "title": "Negăsit",
  "status": 404,
  "detail": "Resursa nu există sau aparține altei organizații.",
  "code": "not_found"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl -X POST "https://api.worbo.app/v1/contacts/123/identities" \
  -H "Authorization: Bearer $WORBO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "email",
    "value": "ana@example.com",
    "primary": false
  }'

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.worbo.app/v1/contacts/123/identities', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
        'Idempotency-Key' => bin2hex(random_bytes(16)),
    ],
    'json' => [
        'type' => 'email',
        'value' => 'ana@example.com',
        'primary' => false,
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/contacts/123/identities', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "type": "email",
    "value": "ana@example.com",
    "primary": false,
  }),
});

const data = await response.json();

import os
import uuid

import requests

response = requests.post(
    "https://api.worbo.app/v1/contacts/123/identities",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "type": "email",
        "value": "ana@example.com",
        "primary": False,
    },
)

data = response.json()

{
  "data": {
    "id": 501,
    "type": "phone",
    "value": "+40722123456",
    "source": "string",
    "primary": true
  }
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/not_found",
  "title": "Negăsit",
  "status": 404,
  "detail": "Resursa nu există sau aparține altei organizații.",
  "code": "not_found"
}

{
  "type": "https://worbo.app/docs/api/errors/idempotency_conflict",
  "title": "Idempotency-Key a fost folosită pentru altă cerere",
  "status": 409,
  "detail": "Idempotency-Key a fost folosit pentru altă cerere.",
  "code": "idempotency_conflict"
}

{
  "type": "https://worbo.app/docs/api/errors/validation_failed",
  "title": "Cererea nu este validă",
  "status": 422,
  "detail": "Un parametru lipsește, nu e valid sau nu e cunoscut; câmpul errors spune care.",
  "code": "validation_failed"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl -X DELETE "https://api.worbo.app/v1/contacts/123/identities/501" \
  -H "Authorization: Bearer $WORBO_API_KEY"

$client = new \GuzzleHttp\Client();

$response = $client->request('DELETE', 'https://api.worbo.app/v1/contacts/123/identities/501', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
    ],
]);

const response = await fetch('https://api.worbo.app/v1/contacts/123/identities/501', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
  },
});

import os

import requests

response = requests.delete(
    "https://api.worbo.app/v1/contacts/123/identities/501",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
    },
)

Fără conținut

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/not_found",
  "title": "Negăsit",
  "status": 404,
  "detail": "Resursa nu există sau aparține altei organizații.",
  "code": "not_found"
}

{
  "type": "https://worbo.app/docs/api/errors/idempotency_conflict",
  "title": "Idempotency-Key a fost folosită pentru altă cerere",
  "status": 409,
  "detail": "Idempotency-Key a fost folosit pentru altă cerere.",
  "code": "idempotency_conflict"
}

{
  "type": "https://worbo.app/docs/api/errors/validation_failed",
  "title": "Cererea nu este validă",
  "status": 422,
  "detail": "Un parametru lipsește, nu e valid sau nu e cunoscut; câmpul errors spune care.",
  "code": "validation_failed"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl -X POST "https://api.worbo.app/v1/contacts/123/merge" \
  -H "Authorization: Bearer $WORBO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "contact_id": 124
  }'

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.worbo.app/v1/contacts/123/merge', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
        'Idempotency-Key' => bin2hex(random_bytes(16)),
    ],
    'json' => [
        'contact_id' => 124,
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/contacts/123/merge', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "contact_id": 124,
  }),
});

const data = await response.json();

import os
import uuid

import requests

response = requests.post(
    "https://api.worbo.app/v1/contacts/123/merge",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "contact_id": 124,
    },
)

data = response.json()

{
  "data": {
    "id": 123,
    "identities": [
      {
        "id": 501,
        "type": "phone",
        "value": "+40722123456",
        "source": "string",
        "primary": true
      }
    ],
    "fields": {
      "first_name": "Ana",
      "last_name": "Popescu",
      "language": "ro"
    },
    "tags": [
      "vip"
    ],
    "source": "api",
    "blocked": false,
    "created_at": "2026-10-15T09:00:00+03:00",
    "updated_at": "2026-10-15T09:00:00+03:00"
  }
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/not_found",
  "title": "Negăsit",
  "status": 404,
  "detail": "Resursa nu există sau aparține altei organizații.",
  "code": "not_found"
}

{
  "type": "https://worbo.app/docs/api/errors/idempotency_conflict",
  "title": "Idempotency-Key a fost folosită pentru altă cerere",
  "status": 409,
  "detail": "Idempotency-Key a fost folosit pentru altă cerere.",
  "code": "idempotency_conflict"
}

{
  "type": "https://worbo.app/docs/api/errors/validation_failed",
  "title": "Cererea nu este validă",
  "status": 422,
  "detail": "Un parametru lipsește, nu e valid sau nu e cunoscut; câmpul errors spune care.",
  "code": "validation_failed"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl "https://api.worbo.app/v1/contacts/123/consents" \
  -H "Authorization: Bearer $WORBO_API_KEY"

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.worbo.app/v1/contacts/123/consents', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/contacts/123/consents', {
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
  },
});

const data = await response.json();

import os

import requests

response = requests.get(
    "https://api.worbo.app/v1/contacts/123/consents",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
    },
)

data = response.json()

{
  "data": {
    "status": {
      "purposes": {
        "channel": "granted",
        "transactional": null,
        "marketing": "granted",
        "recommendations": null
      },
      "topics": {},
      "meta_blocked": false,
      "blocked": false,
      "allowed": {
        "transactional": true,
        "marketing": true,
        "recommendations": false
      }
    },
    "history": [
      {
        "id": 900,
        "purpose": "marketing",
        "topic": "string",
        "state": "granted",
        "basis": "consent",
        "source": "form",
        "proof": {},
        "occurred_at": "2026-10-15T09:00:00+03:00"
      }
    ]
  }
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/not_found",
  "title": "Negăsit",
  "status": 404,
  "detail": "Resursa nu există sau aparține altei organizații.",
  "code": "not_found"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl -X POST "https://api.worbo.app/v1/contacts/123/consents" \
  -H "Authorization: Bearer $WORBO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "purposes": [
      "channel",
      "marketing"
    ],
    "state": "granted",
    "source": "form",
    "proof": {
      "form": "Newsletter, footer",
      "text": "I agree to receive offers on WhatsApp"
    }
  }'

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.worbo.app/v1/contacts/123/consents', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
        'Idempotency-Key' => bin2hex(random_bytes(16)),
    ],
    'json' => [
        'purposes' => [
            'channel',
            'marketing',
        ],
        'state' => 'granted',
        'source' => 'form',
        'proof' => [
            'form' => 'Newsletter, footer',
            'text' => 'I agree to receive offers on WhatsApp',
        ],
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/contacts/123/consents', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "purposes": [
      "channel",
      "marketing",
    ],
    "state": "granted",
    "source": "form",
    "proof": {
      "form": "Newsletter, footer",
      "text": "I agree to receive offers on WhatsApp",
    },
  }),
});

const data = await response.json();

import os
import uuid

import requests

response = requests.post(
    "https://api.worbo.app/v1/contacts/123/consents",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "purposes": [
            "channel",
            "marketing",
        ],
        "state": "granted",
        "source": "form",
        "proof": {
            "form": "Newsletter, footer",
            "text": "I agree to receive offers on WhatsApp",
        },
    },
)

data = response.json()

{
  "data": {
    "recorded": [
      {
        "id": 900,
        "purpose": "marketing",
        "topic": "string",
        "state": "granted",
        "basis": "consent",
        "source": "form",
        "proof": {},
        "occurred_at": "2026-10-15T09:00:00+03:00"
      }
    ],
    "status": {
      "purposes": {
        "channel": "granted",
        "transactional": null,
        "marketing": "granted",
        "recommendations": null
      },
      "topics": {},
      "meta_blocked": false,
      "blocked": false,
      "allowed": {
        "transactional": true,
        "marketing": true,
        "recommendations": false
      }
    },
    "history": [
      {
        "id": 900,
        "purpose": "marketing",
        "topic": "string",
        "state": "granted",
        "basis": "consent",
        "source": "form",
        "proof": {},
        "occurred_at": "2026-10-15T09:00:00+03:00"
      }
    ]
  }
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/not_found",
  "title": "Negăsit",
  "status": 404,
  "detail": "Resursa nu există sau aparține altei organizații.",
  "code": "not_found"
}

{
  "type": "https://worbo.app/docs/api/errors/idempotency_conflict",
  "title": "Idempotency-Key a fost folosită pentru altă cerere",
  "status": 409,
  "detail": "Idempotency-Key a fost folosit pentru altă cerere.",
  "code": "idempotency_conflict"
}

{
  "type": "https://worbo.app/docs/api/errors/validation_failed",
  "title": "Cererea nu este validă",
  "status": 422,
  "detail": "Un parametru lipsește, nu e valid sau nu e cunoscut; câmpul errors spune care.",
  "code": "validation_failed"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl -X POST "https://api.worbo.app/v1/preference-links" \
  -H "Authorization: Bearer $WORBO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "contact_id": 123
  }'

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.worbo.app/v1/preference-links', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
        'Idempotency-Key' => bin2hex(random_bytes(16)),
    ],
    'json' => [
        'contact_id' => 123,
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/preference-links', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "contact_id": 123,
  }),
});

const data = await response.json();

import os
import uuid

import requests

response = requests.post(
    "https://api.worbo.app/v1/preference-links",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "contact_id": 123,
    },
)

data = response.json()

{
  "data": {
    "contact_id": 123,
    "url": "https://my.worbo.app/preferences/abc",
    "expires_at": "2026-10-15T09:00:00+03:00"
  }
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/idempotency_conflict",
  "title": "Idempotency-Key a fost folosită pentru altă cerere",
  "status": 409,
  "detail": "Idempotency-Key a fost folosit pentru altă cerere.",
  "code": "idempotency_conflict"
}

{
  "type": "https://worbo.app/docs/api/errors/validation_failed",
  "title": "Cererea nu este validă",
  "status": 422,
  "detail": "Un parametru lipsește, nu e valid sau nu e cunoscut; câmpul errors spune care.",
  "code": "validation_failed"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl "https://api.worbo.app/v1/contacts/schema" \
  -H "Authorization: Bearer $WORBO_API_KEY"

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.worbo.app/v1/contacts/schema', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/contacts/schema', {
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
  },
});

const data = await response.json();

import os

import requests

response = requests.get(
    "https://api.worbo.app/v1/contacts/schema",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
    },
)

data = response.json()

{
  "data": {}
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl "https://api.worbo.app/v1/field-definitions" \
  -H "Authorization: Bearer $WORBO_API_KEY"

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.worbo.app/v1/field-definitions', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/field-definitions', {
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
  },
});

const data = await response.json();

import os

import requests

response = requests.get(
    "https://api.worbo.app/v1/field-definitions",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
    },
)

data = response.json()

{
  "data": [
    {
      "key": "shoe_size",
      "label": "Shoe size",
      "labels": {},
      "type": "number",
      "required": false,
      "unique": false,
      "sensitivity": "normal",
      "key_date": false,
      "calculated": false,
      "multiple": false,
      "choices": [
        {
          "key": "string",
          "labels": {}
        }
      ],
      "default": {},
      "archived": false
    }
  ]
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl -X POST "https://api.worbo.app/v1/field-definitions" \
  -H "Authorization: Bearer $WORBO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "object_type": "vehicle",
    "labels": {
      "en": "Plate",
      "ro": "Număr de înmatriculare"
    },
    "key": "plate",
    "type": "text"
  }'

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.worbo.app/v1/field-definitions', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
        'Idempotency-Key' => bin2hex(random_bytes(16)),
    ],
    'json' => [
        'object_type' => 'vehicle',
        'labels' => [
            'en' => 'Plate',
            'ro' => 'Număr de înmatriculare',
        ],
        'key' => 'plate',
        'type' => 'text',
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/field-definitions', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "object_type": "vehicle",
    "labels": {
      "en": "Plate",
      "ro": "Număr de înmatriculare",
    },
    "key": "plate",
    "type": "text",
  }),
});

const data = await response.json();

import os
import uuid

import requests

response = requests.post(
    "https://api.worbo.app/v1/field-definitions",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "object_type": "vehicle",
        "labels": {
            "en": "Plate",
            "ro": "Număr de înmatriculare",
        },
        "key": "plate",
        "type": "text",
    },
)

data = response.json()

{
  "data": {
    "key": "shoe_size",
    "label": "Shoe size",
    "labels": {},
    "type": "number",
    "required": false,
    "unique": false,
    "sensitivity": "normal",
    "key_date": false,
    "calculated": false,
    "multiple": false,
    "choices": [
      {
        "key": "string",
        "labels": {}
      }
    ],
    "default": {},
    "archived": false
  }
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/idempotency_conflict",
  "title": "Idempotency-Key a fost folosită pentru altă cerere",
  "status": 409,
  "detail": "Idempotency-Key a fost folosit pentru altă cerere.",
  "code": "idempotency_conflict"
}

{
  "type": "https://worbo.app/docs/api/errors/validation_failed",
  "title": "Cererea nu este validă",
  "status": 422,
  "detail": "Un parametru lipsește, nu e valid sau nu e cunoscut; câmpul errors spune care.",
  "code": "validation_failed"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl "https://api.worbo.app/v1/object-types" \
  -H "Authorization: Bearer $WORBO_API_KEY"

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.worbo.app/v1/object-types', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/object-types', {
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
  },
});

const data = await response.json();

import os

import requests

response = requests.get(
    "https://api.worbo.app/v1/object-types",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
    },
)

data = response.json()

{
  "data": [
    {
      "key": "fit.membership",
      "label": "Membership",
      "labels": {},
      "plural_labels": {},
      "source": "fitness",
      "status_axes": [
        {
          "key": "lifecycle",
          "labels": {},
          "statuses": [
            {
              "key": "active",
              "labels": {},
              "category": "active"
            }
          ]
        }
      ],
      "roles": [
        {
          "key": "holder",
          "labels": {},
          "multiple": false,
          "primary": true
        }
      ],
      "fields": [
        {
          "key": "shoe_size",
          "label": "Shoe size",
          "labels": {},
          "type": "number",
          "required": false,
          "unique": false,
          "sensitivity": "normal",
          "key_date": false,
          "calculated": false,
          "multiple": false,
          "choices": [
            {
              "key": "string",
              "labels": {}
            }
          ],
          "default": {},
          "archived": false
        }
      ]
    }
  ]
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl -X POST "https://api.worbo.app/v1/object-types" \
  -H "Authorization: Bearer $WORBO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "labels": {
      "en": "Vehicle",
      "ro": "Vehicul"
    },
    "key": "vehicle"
  }'

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.worbo.app/v1/object-types', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
        'Idempotency-Key' => bin2hex(random_bytes(16)),
    ],
    'json' => [
        'labels' => [
            'en' => 'Vehicle',
            'ro' => 'Vehicul',
        ],
        'key' => 'vehicle',
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/object-types', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "labels": {
      "en": "Vehicle",
      "ro": "Vehicul",
    },
    "key": "vehicle",
  }),
});

const data = await response.json();

import os
import uuid

import requests

response = requests.post(
    "https://api.worbo.app/v1/object-types",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "labels": {
            "en": "Vehicle",
            "ro": "Vehicul",
        },
        "key": "vehicle",
    },
)

data = response.json()

{
  "data": {
    "key": "fit.membership",
    "label": "Membership",
    "labels": {},
    "plural_labels": {},
    "source": "fitness",
    "status_axes": [
      {
        "key": "lifecycle",
        "labels": {},
        "statuses": [
          {
            "key": "active",
            "labels": {},
            "category": "active"
          }
        ]
      }
    ],
    "roles": [
      {
        "key": "holder",
        "labels": {},
        "multiple": false,
        "primary": true
      }
    ],
    "fields": [
      {
        "key": "shoe_size",
        "label": "Shoe size",
        "labels": {},
        "type": "number",
        "required": false,
        "unique": false,
        "sensitivity": "normal",
        "key_date": false,
        "calculated": false,
        "multiple": false,
        "choices": [
          {
            "key": "string",
            "labels": {}
          }
        ],
        "default": {},
        "archived": false
      }
    ]
  }
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/idempotency_conflict",
  "title": "Idempotency-Key a fost folosită pentru altă cerere",
  "status": 409,
  "detail": "Idempotency-Key a fost folosit pentru altă cerere.",
  "code": "idempotency_conflict"
}

{
  "type": "https://worbo.app/docs/api/errors/validation_failed",
  "title": "Cererea nu este validă",
  "status": 422,
  "detail": "Un parametru lipsește, nu e valid sau nu e cunoscut; câmpul errors spune care.",
  "code": "validation_failed"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl "https://api.worbo.app/v1/object-types/fit.membership" \
  -H "Authorization: Bearer $WORBO_API_KEY"

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.worbo.app/v1/object-types/fit.membership', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/object-types/fit.membership', {
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
  },
});

const data = await response.json();

import os

import requests

response = requests.get(
    "https://api.worbo.app/v1/object-types/fit.membership",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
    },
)

data = response.json()

{
  "data": {
    "key": "fit.membership",
    "label": "Membership",
    "labels": {},
    "plural_labels": {},
    "source": "fitness",
    "status_axes": [
      {
        "key": "lifecycle",
        "labels": {},
        "statuses": [
          {
            "key": "active",
            "labels": {},
            "category": "active"
          }
        ]
      }
    ],
    "roles": [
      {
        "key": "holder",
        "labels": {},
        "multiple": false,
        "primary": true
      }
    ],
    "fields": [
      {
        "key": "shoe_size",
        "label": "Shoe size",
        "labels": {},
        "type": "number",
        "required": false,
        "unique": false,
        "sensitivity": "normal",
        "key_date": false,
        "calculated": false,
        "multiple": false,
        "choices": [
          {
            "key": "string",
            "labels": {}
          }
        ],
        "default": {},
        "archived": false
      }
    ]
  }
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/not_found",
  "title": "Negăsit",
  "status": 404,
  "detail": "Resursa nu există sau aparține altei organizații.",
  "code": "not_found"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl "https://api.worbo.app/v1/object-types/fit.membership/schema" \
  -H "Authorization: Bearer $WORBO_API_KEY"

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.worbo.app/v1/object-types/fit.membership/schema', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/object-types/fit.membership/schema', {
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
  },
});

const data = await response.json();

import os

import requests

response = requests.get(
    "https://api.worbo.app/v1/object-types/fit.membership/schema",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
    },
)

data = response.json()

{
  "data": {}
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/not_found",
  "title": "Negăsit",
  "status": 404,
  "detail": "Resursa nu există sau aparține altei organizații.",
  "code": "not_found"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl "https://api.worbo.app/v1/event-types" \
  -H "Authorization: Bearer $WORBO_API_KEY"

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.worbo.app/v1/event-types', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/event-types', {
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
  },
});

const data = await response.json();

import os

import requests

response = requests.get(
    "https://api.worbo.app/v1/event-types",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
    },
)

data = response.json()

{
  "data": [
    {
      "key": "visit.recorded",
      "label": "Visit recorded",
      "labels": {},
      "source": "fitness",
      "violation_policy": "reject",
      "properties": [
        {
          "key": "shoe_size",
          "label": "Shoe size",
          "labels": {},
          "type": "number",
          "required": false,
          "unique": false,
          "sensitivity": "normal",
          "key_date": false,
          "calculated": false,
          "multiple": false,
          "choices": [
            {
              "key": "string",
              "labels": {}
            }
          ],
          "default": {},
          "archived": false
        }
      ]
    }
  ]
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl "https://api.worbo.app/v1/event-types/fit.membership" \
  -H "Authorization: Bearer $WORBO_API_KEY"

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.worbo.app/v1/event-types/fit.membership', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/event-types/fit.membership', {
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
  },
});

const data = await response.json();

import os

import requests

response = requests.get(
    "https://api.worbo.app/v1/event-types/fit.membership",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
    },
)

data = response.json()

{
  "data": {
    "key": "visit.recorded",
    "label": "Visit recorded",
    "labels": {},
    "source": "fitness",
    "violation_policy": "reject",
    "properties": [
      {
        "key": "shoe_size",
        "label": "Shoe size",
        "labels": {},
        "type": "number",
        "required": false,
        "unique": false,
        "sensitivity": "normal",
        "key_date": false,
        "calculated": false,
        "multiple": false,
        "choices": [
          {
            "key": "string",
            "labels": {}
          }
        ],
        "default": {},
        "archived": false
      }
    ]
  }
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/not_found",
  "title": "Negăsit",
  "status": 404,
  "detail": "Resursa nu există sau aparține altei organizații.",
  "code": "not_found"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl "https://api.worbo.app/v1/event-types/fit.membership/schema" \
  -H "Authorization: Bearer $WORBO_API_KEY"

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.worbo.app/v1/event-types/fit.membership/schema', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/event-types/fit.membership/schema', {
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
  },
});

const data = await response.json();

import os

import requests

response = requests.get(
    "https://api.worbo.app/v1/event-types/fit.membership/schema",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
    },
)

data = response.json()

{
  "data": {}
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/not_found",
  "title": "Negăsit",
  "status": 404,
  "detail": "Resursa nu există sau aparține altei organizații.",
  "code": "not_found"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl "https://api.worbo.app/v1/objects/fit.membership" \
  -H "Authorization: Bearer $WORBO_API_KEY"

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.worbo.app/v1/objects/fit.membership', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/objects/fit.membership', {
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
  },
});

const data = await response.json();

import os

import requests

response = requests.get(
    "https://api.worbo.app/v1/objects/fit.membership",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
    },
)

data = response.json()

{
  "data": [
    {
      "id": 456,
      "type": "fit.membership",
      "source": "string",
      "external_id": "abn-7781",
      "title": "Full access 12 luni",
      "fields": {
        "plan": 12,
        "starts_on": "2026-09-01",
        "ends_on": "2027-08-31"
      },
      "statuses": {
        "lifecycle": "active",
        "payment": "ok"
      },
      "raw_status": "string",
      "relations": [
        {
          "id": 77,
          "contact_id": 123,
          "role": "holder",
          "primary": true,
          "muted": false,
          "valid_from": "2026-10-15",
          "valid_until": "2026-10-15"
        }
      ],
      "created_at": "2026-10-15T09:00:00+03:00",
      "updated_at": "2026-10-15T09:00:00+03:00"
    }
  ],
  "next_cursor": "string",
  "has_more": true
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/not_found",
  "title": "Negăsit",
  "status": 404,
  "detail": "Resursa nu există sau aparține altei organizații.",
  "code": "not_found"
}

{
  "type": "https://worbo.app/docs/api/errors/validation_failed",
  "title": "Cererea nu este validă",
  "status": 422,
  "detail": "Un parametru lipsește, nu e valid sau nu e cunoscut; câmpul errors spune care.",
  "code": "validation_failed"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl -X POST "https://api.worbo.app/v1/objects/fit.membership" \
  -H "Authorization: Bearer $WORBO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "abn-7781",
    "source": "upfit",
    "fields": {
      "starts_on": "2026-09-01",
      "ends_on": "2027-08-31"
    },
    "statuses": {
      "lifecycle": "active"
    },
    "contact": {
      "identities": {
        "phone": "+40722123456"
      }
    },
    "role": "holder",
    "update_existing_only": false
  }'

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.worbo.app/v1/objects/fit.membership', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
        'Idempotency-Key' => bin2hex(random_bytes(16)),
    ],
    'json' => [
        'external_id' => 'abn-7781',
        'source' => 'upfit',
        'fields' => [
            'starts_on' => '2026-09-01',
            'ends_on' => '2027-08-31',
        ],
        'statuses' => [
            'lifecycle' => 'active',
        ],
        'contact' => [
            'identities' => [
                'phone' => '+40722123456',
            ],
        ],
        'role' => 'holder',
        'update_existing_only' => false,
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/objects/fit.membership', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "external_id": "abn-7781",
    "source": "upfit",
    "fields": {
      "starts_on": "2026-09-01",
      "ends_on": "2027-08-31",
    },
    "statuses": {
      "lifecycle": "active",
    },
    "contact": {
      "identities": {
        "phone": "+40722123456",
      },
    },
    "role": "holder",
    "update_existing_only": false,
  }),
});

const data = await response.json();

import os
import uuid

import requests

response = requests.post(
    "https://api.worbo.app/v1/objects/fit.membership",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "external_id": "abn-7781",
        "source": "upfit",
        "fields": {
            "starts_on": "2026-09-01",
            "ends_on": "2027-08-31",
        },
        "statuses": {
            "lifecycle": "active",
        },
        "contact": {
            "identities": {
                "phone": "+40722123456",
            },
        },
        "role": "holder",
        "update_existing_only": False,
    },
)

data = response.json()

{
  "data": {
    "id": 456,
    "type": "fit.membership",
    "source": "string",
    "external_id": "abn-7781",
    "title": "Full access 12 luni",
    "fields": {
      "plan": 12,
      "starts_on": "2026-09-01",
      "ends_on": "2027-08-31"
    },
    "statuses": {
      "lifecycle": "active",
      "payment": "ok"
    },
    "raw_status": "string",
    "relations": [
      {
        "id": 77,
        "contact_id": 123,
        "role": "holder",
        "primary": true,
        "muted": false,
        "valid_from": "2026-10-15",
        "valid_until": "2026-10-15"
      }
    ],
    "created_at": "2026-10-15T09:00:00+03:00",
    "updated_at": "2026-10-15T09:00:00+03:00"
  }
}

{
  "data": {
    "id": 456,
    "type": "fit.membership",
    "source": "string",
    "external_id": "abn-7781",
    "title": "Full access 12 luni",
    "fields": {
      "plan": 12,
      "starts_on": "2026-09-01",
      "ends_on": "2027-08-31"
    },
    "statuses": {
      "lifecycle": "active",
      "payment": "ok"
    },
    "raw_status": "string",
    "relations": [
      {
        "id": 77,
        "contact_id": 123,
        "role": "holder",
        "primary": true,
        "muted": false,
        "valid_from": "2026-10-15",
        "valid_until": "2026-10-15"
      }
    ],
    "created_at": "2026-10-15T09:00:00+03:00",
    "updated_at": "2026-10-15T09:00:00+03:00"
  }
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/not_found",
  "title": "Negăsit",
  "status": 404,
  "detail": "Resursa nu există sau aparține altei organizații.",
  "code": "not_found"
}

{
  "type": "https://worbo.app/docs/api/errors/idempotency_conflict",
  "title": "Idempotency-Key a fost folosită pentru altă cerere",
  "status": 409,
  "detail": "Idempotency-Key a fost folosit pentru altă cerere.",
  "code": "idempotency_conflict"
}

{
  "type": "https://worbo.app/docs/api/errors/validation_failed",
  "title": "Cererea nu este validă",
  "status": 422,
  "detail": "Un parametru lipsește, nu e valid sau nu e cunoscut; câmpul errors spune care.",
  "code": "validation_failed"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl -X POST "https://api.worbo.app/v1/objects/fit.membership/batch" \
  -H "Authorization: Bearer $WORBO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "external_id": "abn-7781",
        "source": "upfit",
        "fields": {
          "starts_on": "2026-09-01",
          "ends_on": "2027-08-31"
        },
        "statuses": {
          "lifecycle": "active"
        },
        "contact": {
          "identities": {
            "phone": "+40722123456"
          }
        },
        "role": "holder",
        "update_existing_only": false
      }
    ]
  }'

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.worbo.app/v1/objects/fit.membership/batch', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
        'Idempotency-Key' => bin2hex(random_bytes(16)),
    ],
    'json' => [
        'items' => [
            [
                'external_id' => 'abn-7781',
                'source' => 'upfit',
                'fields' => [
                    'starts_on' => '2026-09-01',
                    'ends_on' => '2027-08-31',
                ],
                'statuses' => [
                    'lifecycle' => 'active',
                ],
                'contact' => [
                    'identities' => [
                        'phone' => '+40722123456',
                    ],
                ],
                'role' => 'holder',
                'update_existing_only' => false,
            ],
        ],
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/objects/fit.membership/batch', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "items": [
      {
        "external_id": "abn-7781",
        "source": "upfit",
        "fields": {
          "starts_on": "2026-09-01",
          "ends_on": "2027-08-31",
        },
        "statuses": {
          "lifecycle": "active",
        },
        "contact": {
          "identities": {
            "phone": "+40722123456",
          },
        },
        "role": "holder",
        "update_existing_only": false,
      },
    ],
  }),
});

const data = await response.json();

import os
import uuid

import requests

response = requests.post(
    "https://api.worbo.app/v1/objects/fit.membership/batch",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "items": [
            {
                "external_id": "abn-7781",
                "source": "upfit",
                "fields": {
                    "starts_on": "2026-09-01",
                    "ends_on": "2027-08-31",
                },
                "statuses": {
                    "lifecycle": "active",
                },
                "contact": {
                    "identities": {
                        "phone": "+40722123456",
                    },
                },
                "role": "holder",
                "update_existing_only": False,
            },
        ],
    },
)

data = response.json()

{
  "data": [
    {
      "index": 0,
      "status": "created",
      "data": {
        "id": 456,
        "type": "fit.membership",
        "source": "string",
        "external_id": "abn-7781",
        "title": "Full access 12 luni",
        "fields": {
          "plan": 12,
          "starts_on": "2026-09-01",
          "ends_on": "2027-08-31"
        },
        "statuses": {
          "lifecycle": "active",
          "payment": "ok"
        },
        "raw_status": "string",
        "relations": [
          {
            "id": 77,
            "contact_id": 123,
            "role": "holder",
            "primary": true,
            "muted": false,
            "valid_from": "2026-10-15",
            "valid_until": "2026-10-15"
          }
        ],
        "created_at": "2026-10-15T09:00:00+03:00",
        "updated_at": "2026-10-15T09:00:00+03:00"
      },
      "error": {
        "type": "https://worbo.app/docs/api/errors/validation_failed",
        "title": "The request is not valid",
        "status": 422,
        "detail": "The name field is required.",
        "code": "validation_failed",
        "errors": {
          "name": [
            "The name field is required."
          ]
        }
      }
    }
  ]
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/not_found",
  "title": "Negăsit",
  "status": 404,
  "detail": "Resursa nu există sau aparține altei organizații.",
  "code": "not_found"
}

{
  "type": "https://worbo.app/docs/api/errors/idempotency_conflict",
  "title": "Idempotency-Key a fost folosită pentru altă cerere",
  "status": 409,
  "detail": "Idempotency-Key a fost folosit pentru altă cerere.",
  "code": "idempotency_conflict"
}

{
  "type": "https://worbo.app/docs/api/errors/validation_failed",
  "title": "Cererea nu este validă",
  "status": 422,
  "detail": "Un parametru lipsește, nu e valid sau nu e cunoscut; câmpul errors spune care.",
  "code": "validation_failed"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl "https://api.worbo.app/v1/objects/fit.membership/456" \
  -H "Authorization: Bearer $WORBO_API_KEY"

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.worbo.app/v1/objects/fit.membership/456', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/objects/fit.membership/456', {
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
  },
});

const data = await response.json();

import os

import requests

response = requests.get(
    "https://api.worbo.app/v1/objects/fit.membership/456",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
    },
)

data = response.json()

{
  "data": {
    "id": 456,
    "type": "fit.membership",
    "source": "string",
    "external_id": "abn-7781",
    "title": "Full access 12 luni",
    "fields": {
      "plan": 12,
      "starts_on": "2026-09-01",
      "ends_on": "2027-08-31"
    },
    "statuses": {
      "lifecycle": "active",
      "payment": "ok"
    },
    "raw_status": "string",
    "relations": [
      {
        "id": 77,
        "contact_id": 123,
        "role": "holder",
        "primary": true,
        "muted": false,
        "valid_from": "2026-10-15",
        "valid_until": "2026-10-15"
      }
    ],
    "created_at": "2026-10-15T09:00:00+03:00",
    "updated_at": "2026-10-15T09:00:00+03:00"
  }
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/not_found",
  "title": "Negăsit",
  "status": 404,
  "detail": "Resursa nu există sau aparține altei organizații.",
  "code": "not_found"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl -X PATCH "https://api.worbo.app/v1/objects/fit.membership/456" \
  -H "Authorization: Bearer $WORBO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "statuses": {
      "lifecycle": "frozen"
    }
  }'

$client = new \GuzzleHttp\Client();

$response = $client->request('PATCH', 'https://api.worbo.app/v1/objects/fit.membership/456', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
    ],
    'json' => [
        'statuses' => [
            'lifecycle' => 'frozen',
        ],
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/objects/fit.membership/456', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "statuses": {
      "lifecycle": "frozen",
    },
  }),
});

const data = await response.json();

import os

import requests

response = requests.patch(
    "https://api.worbo.app/v1/objects/fit.membership/456",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
    },
    json={
        "statuses": {
            "lifecycle": "frozen",
        },
    },
)

data = response.json()

{
  "data": {
    "id": 456,
    "type": "fit.membership",
    "source": "string",
    "external_id": "abn-7781",
    "title": "Full access 12 luni",
    "fields": {
      "plan": 12,
      "starts_on": "2026-09-01",
      "ends_on": "2027-08-31"
    },
    "statuses": {
      "lifecycle": "active",
      "payment": "ok"
    },
    "raw_status": "string",
    "relations": [
      {
        "id": 77,
        "contact_id": 123,
        "role": "holder",
        "primary": true,
        "muted": false,
        "valid_from": "2026-10-15",
        "valid_until": "2026-10-15"
      }
    ],
    "created_at": "2026-10-15T09:00:00+03:00",
    "updated_at": "2026-10-15T09:00:00+03:00"
  }
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/not_found",
  "title": "Negăsit",
  "status": 404,
  "detail": "Resursa nu există sau aparține altei organizații.",
  "code": "not_found"
}

{
  "type": "https://worbo.app/docs/api/errors/idempotency_conflict",
  "title": "Idempotency-Key a fost folosită pentru altă cerere",
  "status": 409,
  "detail": "Idempotency-Key a fost folosit pentru altă cerere.",
  "code": "idempotency_conflict"
}

{
  "type": "https://worbo.app/docs/api/errors/validation_failed",
  "title": "Cererea nu este validă",
  "status": 422,
  "detail": "Un parametru lipsește, nu e valid sau nu e cunoscut; câmpul errors spune care.",
  "code": "validation_failed"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl -X POST "https://api.worbo.app/v1/objects/fit.membership/456/relations" \
  -H "Authorization: Bearer $WORBO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "contact_id": 123,
    "role": "beneficiary",
    "primary": false,
    "muted": false
  }'

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.worbo.app/v1/objects/fit.membership/456/relations', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
        'Idempotency-Key' => bin2hex(random_bytes(16)),
    ],
    'json' => [
        'contact_id' => 123,
        'role' => 'beneficiary',
        'primary' => false,
        'muted' => false,
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/objects/fit.membership/456/relations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "contact_id": 123,
    "role": "beneficiary",
    "primary": false,
    "muted": false,
  }),
});

const data = await response.json();

import os
import uuid

import requests

response = requests.post(
    "https://api.worbo.app/v1/objects/fit.membership/456/relations",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "contact_id": 123,
        "role": "beneficiary",
        "primary": False,
        "muted": False,
    },
)

data = response.json()

{
  "data": {
    "id": 77,
    "contact_id": 123,
    "role": "holder",
    "primary": true,
    "muted": false,
    "valid_from": "2026-10-15",
    "valid_until": "2026-10-15"
  }
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/not_found",
  "title": "Negăsit",
  "status": 404,
  "detail": "Resursa nu există sau aparține altei organizații.",
  "code": "not_found"
}

{
  "type": "https://worbo.app/docs/api/errors/idempotency_conflict",
  "title": "Idempotency-Key a fost folosită pentru altă cerere",
  "status": 409,
  "detail": "Idempotency-Key a fost folosit pentru altă cerere.",
  "code": "idempotency_conflict"
}

{
  "type": "https://worbo.app/docs/api/errors/validation_failed",
  "title": "Cererea nu este validă",
  "status": 422,
  "detail": "Un parametru lipsește, nu e valid sau nu e cunoscut; câmpul errors spune care.",
  "code": "validation_failed"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl -X DELETE "https://api.worbo.app/v1/objects/fit.membership/456/relations/77" \
  -H "Authorization: Bearer $WORBO_API_KEY"

$client = new \GuzzleHttp\Client();

$response = $client->request('DELETE', 'https://api.worbo.app/v1/objects/fit.membership/456/relations/77', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
    ],
]);

const response = await fetch('https://api.worbo.app/v1/objects/fit.membership/456/relations/77', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
  },
});

import os

import requests

response = requests.delete(
    "https://api.worbo.app/v1/objects/fit.membership/456/relations/77",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
    },
)

Fără conținut

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/not_found",
  "title": "Negăsit",
  "status": 404,
  "detail": "Resursa nu există sau aparține altei organizații.",
  "code": "not_found"
}

{
  "type": "https://worbo.app/docs/api/errors/idempotency_conflict",
  "title": "Idempotency-Key a fost folosită pentru altă cerere",
  "status": 409,
  "detail": "Idempotency-Key a fost folosit pentru altă cerere.",
  "code": "idempotency_conflict"
}

{
  "type": "https://worbo.app/docs/api/errors/validation_failed",
  "title": "Cererea nu este validă",
  "status": 422,
  "detail": "Un parametru lipsește, nu e valid sau nu e cunoscut; câmpul errors spune care.",
  "code": "validation_failed"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl -X POST "https://api.worbo.app/v1/files" \
  -H "Authorization: Bearer $WORBO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -F "file=@document.pdf"

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.worbo.app/v1/files', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
        'Idempotency-Key' => bin2hex(random_bytes(16)),
    ],
    'multipart' => [
        ['name' => 'file', 'contents' => fopen('document.pdf', 'r')],
    ],
]);

$data = json_decode((string) $response->getBody(), true);

import { openAsBlob } from 'node:fs';

const form = new FormData();
form.append('file', await openAsBlob('document.pdf'), 'document.pdf');

const response = await fetch('https://api.worbo.app/v1/files', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
  },
  body: form,
});

const data = await response.json();

import os
import uuid

import requests

response = requests.post(
    "https://api.worbo.app/v1/files",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    files={"file": open("document.pdf", "rb")},
)

data = response.json()

{
  "data": {
    "id": 77,
    "name": "contract.pdf",
    "mime": "application/pdf",
    "size": 48213,
    "sha256": "string",
    "contact_id": 123,
    "object_id": 456,
    "created_at": "2026-10-15T09:00:00+03:00"
  }
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/idempotency_conflict",
  "title": "Idempotency-Key a fost folosită pentru altă cerere",
  "status": 409,
  "detail": "Idempotency-Key a fost folosit pentru altă cerere.",
  "code": "idempotency_conflict"
}

{
  "type": "https://worbo.app/docs/api/errors/validation_failed",
  "title": "Cererea nu este validă",
  "status": 422,
  "detail": "Un parametru lipsește, nu e valid sau nu e cunoscut; câmpul errors spune care.",
  "code": "validation_failed"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl "https://api.worbo.app/v1/files/77" \
  -H "Authorization: Bearer $WORBO_API_KEY"

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.worbo.app/v1/files/77', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/files/77', {
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
  },
});

const data = await response.json();

import os

import requests

response = requests.get(
    "https://api.worbo.app/v1/files/77",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
    },
)

data = response.json()

{
  "data": {
    "id": 77,
    "name": "contract.pdf",
    "mime": "application/pdf",
    "size": 48213,
    "sha256": "string",
    "contact_id": 123,
    "object_id": 456,
    "created_at": "2026-10-15T09:00:00+03:00"
  }
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/not_found",
  "title": "Negăsit",
  "status": 404,
  "detail": "Resursa nu există sau aparține altei organizații.",
  "code": "not_found"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl "https://api.worbo.app/v1/files/77/content" \
  -H "Authorization: Bearer $WORBO_API_KEY"

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.worbo.app/v1/files/77/content', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
    ],
]);

file_put_contents('download', (string) $response->getBody());

const response = await fetch('https://api.worbo.app/v1/files/77/content', {
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
  },
});

const file = await response.blob();

import os

import requests

response = requests.get(
    "https://api.worbo.app/v1/files/77/content",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
    },
)

content = response.content

Un fișier, așa cum a fost încărcat.

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/not_found",
  "title": "Negăsit",
  "status": 404,
  "detail": "Resursa nu există sau aparține altei organizații.",
  "code": "not_found"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl -X POST "https://api.worbo.app/v1/events" \
  -H "Authorization: Bearer $WORBO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "m-1",
    "type": "membership.created",
    "occurred_at": "2026-10-15T09:00:00+03:00",
    "source": "upfit",
    "contact": {
      "phone": "+40722123456"
    },
    "object": {
      "type": "fit.membership",
      "external_id": "abn-7781",
      "upsert": {
        "statuses": {
          "lifecycle": "active"
        }
      }
    },
    "properties": {
      "plan": "plan-12"
    },
    "historical": false,
    "update_existing_only": false
  }'

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.worbo.app/v1/events', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
        'Idempotency-Key' => bin2hex(random_bytes(16)),
    ],
    'json' => [
        'id' => 'm-1',
        'type' => 'membership.created',
        'occurred_at' => '2026-10-15T09:00:00+03:00',
        'source' => 'upfit',
        'contact' => [
            'phone' => '+40722123456',
        ],
        'object' => [
            'type' => 'fit.membership',
            'external_id' => 'abn-7781',
            'upsert' => [
                'statuses' => [
                    'lifecycle' => 'active',
                ],
            ],
        ],
        'properties' => [
            'plan' => 'plan-12',
        ],
        'historical' => false,
        'update_existing_only' => false,
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/events', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "id": "m-1",
    "type": "membership.created",
    "occurred_at": "2026-10-15T09:00:00+03:00",
    "source": "upfit",
    "contact": {
      "phone": "+40722123456",
    },
    "object": {
      "type": "fit.membership",
      "external_id": "abn-7781",
      "upsert": {
        "statuses": {
          "lifecycle": "active",
        },
      },
    },
    "properties": {
      "plan": "plan-12",
    },
    "historical": false,
    "update_existing_only": false,
  }),
});

const data = await response.json();

import os
import uuid

import requests

response = requests.post(
    "https://api.worbo.app/v1/events",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "id": "m-1",
        "type": "membership.created",
        "occurred_at": "2026-10-15T09:00:00+03:00",
        "source": "upfit",
        "contact": {
            "phone": "+40722123456",
        },
        "object": {
            "type": "fit.membership",
            "external_id": "abn-7781",
            "upsert": {
                "statuses": {
                    "lifecycle": "active",
                },
            },
        },
        "properties": {
            "plan": "plan-12",
        },
        "historical": False,
        "update_existing_only": False,
    },
)

data = response.json()

{
  "data": {
    "event_id": 8812,
    "type": "membership.created",
    "source": "upfit",
    "source_id": "m-1",
    "occurred_at": "2026-10-15T09:00:00+03:00",
    "duplicate": false,
    "historical": false,
    "contact_id": 123,
    "object_id": 456,
    "warnings": {},
    "identity_conflict": {}
  }
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/idempotency_conflict",
  "title": "Idempotency-Key a fost folosită pentru altă cerere",
  "status": 409,
  "detail": "Idempotency-Key a fost folosit pentru altă cerere.",
  "code": "idempotency_conflict"
}

{
  "type": "https://worbo.app/docs/api/errors/validation_failed",
  "title": "Cererea nu este validă",
  "status": 422,
  "detail": "Un parametru lipsește, nu e valid sau nu e cunoscut; câmpul errors spune care.",
  "code": "validation_failed"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl -X POST "https://api.worbo.app/v1/events/batch" \
  -H "Authorization: Bearer $WORBO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "id": "m-1",
        "type": "membership.created",
        "occurred_at": "2026-10-15T09:00:00+03:00",
        "source": "upfit",
        "contact": {
          "phone": "+40722123456"
        },
        "object": {
          "type": "fit.membership",
          "external_id": "abn-7781",
          "upsert": {
            "statuses": {
              "lifecycle": "active"
            }
          }
        },
        "properties": {
          "plan": "plan-12"
        },
        "historical": false,
        "update_existing_only": false
      }
    ]
  }'

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.worbo.app/v1/events/batch', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
        'Idempotency-Key' => bin2hex(random_bytes(16)),
    ],
    'json' => [
        'items' => [
            [
                'id' => 'm-1',
                'type' => 'membership.created',
                'occurred_at' => '2026-10-15T09:00:00+03:00',
                'source' => 'upfit',
                'contact' => [
                    'phone' => '+40722123456',
                ],
                'object' => [
                    'type' => 'fit.membership',
                    'external_id' => 'abn-7781',
                    'upsert' => [
                        'statuses' => [
                            'lifecycle' => 'active',
                        ],
                    ],
                ],
                'properties' => [
                    'plan' => 'plan-12',
                ],
                'historical' => false,
                'update_existing_only' => false,
            ],
        ],
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/events/batch', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "items": [
      {
        "id": "m-1",
        "type": "membership.created",
        "occurred_at": "2026-10-15T09:00:00+03:00",
        "source": "upfit",
        "contact": {
          "phone": "+40722123456",
        },
        "object": {
          "type": "fit.membership",
          "external_id": "abn-7781",
          "upsert": {
            "statuses": {
              "lifecycle": "active",
            },
          },
        },
        "properties": {
          "plan": "plan-12",
        },
        "historical": false,
        "update_existing_only": false,
      },
    ],
  }),
});

const data = await response.json();

import os
import uuid

import requests

response = requests.post(
    "https://api.worbo.app/v1/events/batch",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "items": [
            {
                "id": "m-1",
                "type": "membership.created",
                "occurred_at": "2026-10-15T09:00:00+03:00",
                "source": "upfit",
                "contact": {
                    "phone": "+40722123456",
                },
                "object": {
                    "type": "fit.membership",
                    "external_id": "abn-7781",
                    "upsert": {
                        "statuses": {
                            "lifecycle": "active",
                        },
                    },
                },
                "properties": {
                    "plan": "plan-12",
                },
                "historical": False,
                "update_existing_only": False,
            },
        ],
    },
)

data = response.json()

{
  "data": [
    {
      "index": 0,
      "status": "created",
      "data": {
        "event_id": 8812,
        "type": "membership.created",
        "source": "upfit",
        "source_id": "m-1",
        "occurred_at": "2026-10-15T09:00:00+03:00",
        "duplicate": false,
        "historical": false,
        "contact_id": 123,
        "object_id": 456,
        "warnings": {},
        "identity_conflict": {}
      },
      "error": {
        "type": "https://worbo.app/docs/api/errors/validation_failed",
        "title": "The request is not valid",
        "status": 422,
        "detail": "The name field is required.",
        "code": "validation_failed",
        "errors": {
          "name": [
            "The name field is required."
          ]
        }
      }
    }
  ]
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/idempotency_conflict",
  "title": "Idempotency-Key a fost folosită pentru altă cerere",
  "status": 409,
  "detail": "Idempotency-Key a fost folosit pentru altă cerere.",
  "code": "idempotency_conflict"
}

{
  "type": "https://worbo.app/docs/api/errors/validation_failed",
  "title": "Cererea nu este validă",
  "status": 422,
  "detail": "Un parametru lipsește, nu e valid sau nu e cunoscut; câmpul errors spune care.",
  "code": "validation_failed"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl "https://api.worbo.app/v1/messages" \
  -H "Authorization: Bearer $WORBO_API_KEY"

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.worbo.app/v1/messages', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/messages', {
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
  },
});

const data = await response.json();

import os

import requests

response = requests.get(
    "https://api.worbo.app/v1/messages",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
    },
)

data = response.json()

{
  "data": [
    {
      "id": 7001,
      "contact_id": 123,
      "number_id": 3,
      "direction": "outbound",
      "type": "template",
      "text": "string",
      "untrusted_text": "string",
      "template": {
        "name": "booking_confirmed",
        "language": "ro"
      },
      "category": "utility",
      "status": "pending",
      "reason": "string",
      "error_code": "string",
      "wamid": "string",
      "created_at": "2026-10-15T09:00:00+03:00",
      "sent_at": "2026-10-15T09:00:00+03:00",
      "delivered_at": "2026-10-15T09:00:00+03:00",
      "read_at": "2026-10-15T09:00:00+03:00",
      "failed_at": "2026-10-15T09:00:00+03:00"
    }
  ],
  "next_cursor": "string",
  "has_more": true
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/validation_failed",
  "title": "Cererea nu este validă",
  "status": 422,
  "detail": "Un parametru lipsește, nu e valid sau nu e cunoscut; câmpul errors spune care.",
  "code": "validation_failed"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl -X POST "https://api.worbo.app/v1/messages" \
  -H "Authorization: Bearer $WORBO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "contact_id": 123,
    "template": {
      "name": "booking_confirmed",
      "language": "ro",
      "variables": [
        "Ana",
        "3 octombrie, 18:00"
      ]
    },
    "flow": {
      "key": "nps",
      "body": "Ne spui în 10 secunde cum a fost?"
    }
  }'

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.worbo.app/v1/messages', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
        'Idempotency-Key' => bin2hex(random_bytes(16)),
    ],
    'json' => [
        'contact_id' => 123,
        'template' => [
            'name' => 'booking_confirmed',
            'language' => 'ro',
            'variables' => [
                'Ana',
                '3 octombrie, 18:00',
            ],
        ],
        'flow' => [
            'key' => 'nps',
            'body' => 'Ne spui în 10 secunde cum a fost?',
        ],
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/messages', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "contact_id": 123,
    "template": {
      "name": "booking_confirmed",
      "language": "ro",
      "variables": [
        "Ana",
        "3 octombrie, 18:00",
      ],
    },
    "flow": {
      "key": "nps",
      "body": "Ne spui în 10 secunde cum a fost?",
    },
  }),
});

const data = await response.json();

import os
import uuid

import requests

response = requests.post(
    "https://api.worbo.app/v1/messages",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "contact_id": 123,
        "template": {
            "name": "booking_confirmed",
            "language": "ro",
            "variables": [
                "Ana",
                "3 octombrie, 18:00",
            ],
        },
        "flow": {
            "key": "nps",
            "body": "Ne spui în 10 secunde cum a fost?",
        },
    },
)

data = response.json()

{
  "data": {
    "id": 7001,
    "contact_id": 123,
    "number_id": 3,
    "direction": "outbound",
    "type": "template",
    "text": "string",
    "untrusted_text": "string",
    "template": {
      "name": "booking_confirmed",
      "language": "ro"
    },
    "category": "utility",
    "status": "pending",
    "reason": "string",
    "error_code": "string",
    "wamid": "string",
    "created_at": "2026-10-15T09:00:00+03:00",
    "sent_at": "2026-10-15T09:00:00+03:00",
    "delivered_at": "2026-10-15T09:00:00+03:00",
    "read_at": "2026-10-15T09:00:00+03:00",
    "failed_at": "2026-10-15T09:00:00+03:00"
  }
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/idempotency_conflict",
  "title": "Idempotency-Key a fost folosită pentru altă cerere",
  "status": 409,
  "detail": "Idempotency-Key a fost folosit pentru altă cerere.",
  "code": "idempotency_conflict"
}

{
  "type": "https://worbo.app/docs/api/errors/validation_failed",
  "title": "Cererea nu este validă",
  "status": 422,
  "detail": "Un parametru lipsește, nu e valid sau nu e cunoscut; câmpul errors spune care.",
  "code": "validation_failed"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl "https://api.worbo.app/v1/messages/7001" \
  -H "Authorization: Bearer $WORBO_API_KEY"

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.worbo.app/v1/messages/7001', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/messages/7001', {
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
  },
});

const data = await response.json();

import os

import requests

response = requests.get(
    "https://api.worbo.app/v1/messages/7001",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
    },
)

data = response.json()

{
  "data": {
    "id": 7001,
    "contact_id": 123,
    "number_id": 3,
    "direction": "outbound",
    "type": "template",
    "text": "string",
    "untrusted_text": "string",
    "template": {
      "name": "booking_confirmed",
      "language": "ro"
    },
    "category": "utility",
    "status": "pending",
    "reason": "string",
    "error_code": "string",
    "wamid": "string",
    "created_at": "2026-10-15T09:00:00+03:00",
    "sent_at": "2026-10-15T09:00:00+03:00",
    "delivered_at": "2026-10-15T09:00:00+03:00",
    "read_at": "2026-10-15T09:00:00+03:00",
    "failed_at": "2026-10-15T09:00:00+03:00"
  }
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/not_found",
  "title": "Negăsit",
  "status": 404,
  "detail": "Resursa nu există sau aparține altei organizații.",
  "code": "not_found"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl "https://api.worbo.app/v1/messages/7001/evidence" \
  -H "Authorization: Bearer $WORBO_API_KEY"

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.worbo.app/v1/messages/7001/evidence', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/messages/7001/evidence', {
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
  },
});

const data = await response.json();

import os

import requests

response = requests.get(
    "https://api.worbo.app/v1/messages/7001/evidence",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
    },
)

data = response.json()

{
  "data": {
    "id": 52,
    "message_id": 7001,
    "contact_id": 123,
    "number_id": 3,
    "template": {
      "name": "withdrawal_received",
      "language": "ro"
    },
    "recipient": "+40722123456",
    "wamid": "string",
    "text": "string",
    "text_sha256": "string",
    "document": {
      "name": "confirmare.pdf",
      "mime": "application/pdf",
      "size": 48213,
      "sha256": "string",
      "stored": true,
      "error": "string",
      "url": "string"
    },
    "sent_at": "2026-10-15T09:00:00+03:00",
    "delivered_at": "2026-10-15T09:00:00+03:00",
    "read_at": "2026-10-15T09:00:00+03:00",
    "failed_at": "2026-10-15T09:00:00+03:00",
    "created_at": "2026-10-15T09:00:00+03:00"
  }
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/not_found",
  "title": "Negăsit",
  "status": 404,
  "detail": "Resursa nu există sau aparține altei organizații.",
  "code": "not_found"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl "https://api.worbo.app/v1/messages/7001/evidence/document" \
  -H "Authorization: Bearer $WORBO_API_KEY"

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.worbo.app/v1/messages/7001/evidence/document', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
    ],
]);

file_put_contents('download', (string) $response->getBody());

const response = await fetch('https://api.worbo.app/v1/messages/7001/evidence/document', {
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
  },
});

const file = await response.blob();

import os

import requests

response = requests.get(
    "https://api.worbo.app/v1/messages/7001/evidence/document",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
    },
)

content = response.content

Un fișier, așa cum a fost încărcat.

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/not_found",
  "title": "Negăsit",
  "status": 404,
  "detail": "Resursa nu există sau aparține altei organizații.",
  "code": "not_found"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl -X POST "https://api.worbo.app/v1/vault" \
  -H "Authorization: Bearer $WORBO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "contact_id": 123,
    "file_id": 77,
    "title": "Rezultatul analizelor"
  }'

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.worbo.app/v1/vault', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
        'Idempotency-Key' => bin2hex(random_bytes(16)),
    ],
    'json' => [
        'contact_id' => 123,
        'file_id' => 77,
        'title' => 'Rezultatul analizelor',
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/vault', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "contact_id": 123,
    "file_id": 77,
    "title": "Rezultatul analizelor",
  }),
});

const data = await response.json();

import os
import uuid

import requests

response = requests.post(
    "https://api.worbo.app/v1/vault",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "contact_id": 123,
        "file_id": 77,
        "title": "Rezultatul analizelor",
    },
)

data = response.json()

{
  "data": {
    "id": 15,
    "contact_id": 123,
    "file_id": 77,
    "number_id": 3,
    "title": "Rezultatul analizelor",
    "state": "active",
    "expires_at": "2026-10-15T09:00:00+03:00",
    "opened_at": "2026-10-15T09:00:00+03:00",
    "opens": 1,
    "message_id": 7001,
    "created_at": "2026-10-15T09:00:00+03:00",
    "url": "https://example.com"
  }
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/idempotency_conflict",
  "title": "Idempotency-Key a fost folosită pentru altă cerere",
  "status": 409,
  "detail": "Idempotency-Key a fost folosit pentru altă cerere.",
  "code": "idempotency_conflict"
}

{
  "type": "https://worbo.app/docs/api/errors/validation_failed",
  "title": "Cererea nu este validă",
  "status": 422,
  "detail": "Un parametru lipsește, nu e valid sau nu e cunoscut; câmpul errors spune care.",
  "code": "validation_failed"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl "https://api.worbo.app/v1/vault/15" \
  -H "Authorization: Bearer $WORBO_API_KEY"

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.worbo.app/v1/vault/15', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/vault/15', {
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
  },
});

const data = await response.json();

import os

import requests

response = requests.get(
    "https://api.worbo.app/v1/vault/15",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
    },
)

data = response.json()

{
  "data": {
    "id": 15,
    "contact_id": 123,
    "file_id": 77,
    "number_id": 3,
    "title": "Rezultatul analizelor",
    "state": "active",
    "expires_at": "2026-10-15T09:00:00+03:00",
    "opened_at": "2026-10-15T09:00:00+03:00",
    "opens": 1,
    "message_id": 7001,
    "created_at": "2026-10-15T09:00:00+03:00",
    "url": "https://example.com"
  }
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/not_found",
  "title": "Negăsit",
  "status": 404,
  "detail": "Resursa nu există sau aparține altei organizații.",
  "code": "not_found"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl -X DELETE "https://api.worbo.app/v1/vault/15" \
  -H "Authorization: Bearer $WORBO_API_KEY"

$client = new \GuzzleHttp\Client();

$response = $client->request('DELETE', 'https://api.worbo.app/v1/vault/15', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
    ],
]);

const response = await fetch('https://api.worbo.app/v1/vault/15', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
  },
});

import os

import requests

response = requests.delete(
    "https://api.worbo.app/v1/vault/15",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
    },
)

Fără conținut

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/not_found",
  "title": "Negăsit",
  "status": 404,
  "detail": "Resursa nu există sau aparține altei organizații.",
  "code": "not_found"
}

{
  "type": "https://worbo.app/docs/api/errors/idempotency_conflict",
  "title": "Idempotency-Key a fost folosită pentru altă cerere",
  "status": 409,
  "detail": "Idempotency-Key a fost folosit pentru altă cerere.",
  "code": "idempotency_conflict"
}

{
  "type": "https://worbo.app/docs/api/errors/validation_failed",
  "title": "Cererea nu este validă",
  "status": 422,
  "detail": "Un parametru lipsește, nu e valid sau nu e cunoscut; câmpul errors spune care.",
  "code": "validation_failed"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl -X POST "https://api.worbo.app/v1/otp" \
  -H "Authorization: Bearer $WORBO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+40722123456",
    "code": "482913",
    "language": "ro",
    "purpose": "login"
  }'

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.worbo.app/v1/otp', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
        'Idempotency-Key' => bin2hex(random_bytes(16)),
    ],
    'json' => [
        'phone' => '+40722123456',
        'code' => '482913',
        'language' => 'ro',
        'purpose' => 'login',
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/otp', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "phone": "+40722123456",
    "code": "482913",
    "language": "ro",
    "purpose": "login",
  }),
});

const data = await response.json();

import os
import uuid

import requests

response = requests.post(
    "https://api.worbo.app/v1/otp",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "phone": "+40722123456",
        "code": "482913",
        "language": "ro",
        "purpose": "login",
    },
)

data = response.json()

{
  "data": {
    "id": 880,
    "phone": "+40722123456",
    "purpose": "login",
    "verifiable": true,
    "expires_at": "2026-10-15T09:00:00+03:00",
    "message_id": 7001,
    "status": "pending"
  }
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/idempotency_conflict",
  "title": "Idempotency-Key a fost folosită pentru altă cerere",
  "status": 409,
  "detail": "Idempotency-Key a fost folosit pentru altă cerere.",
  "code": "idempotency_conflict"
}

{
  "type": "https://worbo.app/docs/api/errors/validation_failed",
  "title": "Cererea nu este validă",
  "status": 422,
  "detail": "Un parametru lipsește, nu e valid sau nu e cunoscut; câmpul errors spune care.",
  "code": "validation_failed"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}

curl -X POST "https://api.worbo.app/v1/otp/880/verify" \
  -H "Authorization: Bearer $WORBO_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "482913"
  }'

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.worbo.app/v1/otp/880/verify', [
    'headers' => [
        'Authorization' => 'Bearer '.getenv('WORBO_API_KEY'),
        'Idempotency-Key' => bin2hex(random_bytes(16)),
    ],
    'json' => [
        'code' => '482913',
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://api.worbo.app/v1/otp/880/verify', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.WORBO_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "code": "482913",
  }),
});

const data = await response.json();

import os
import uuid

import requests

response = requests.post(
    "https://api.worbo.app/v1/otp/880/verify",
    headers={
        "Authorization": f"Bearer {os.environ['WORBO_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "code": "482913",
    },
)

data = response.json()

{
  "data": {
    "id": 880,
    "verified": true,
    "reason": "wrong_code",
    "attempts_left": 4
  }
}

{
  "type": "https://worbo.app/docs/api/errors/invalid_api_key",
  "title": "Cheia API nu este validă",
  "status": 401,
  "detail": "Cheia nu e validă; o cheie pierdută nu se poate recupera, doar înlocui.",
  "code": "invalid_api_key"
}

{
  "type": "https://worbo.app/docs/api/errors/insufficient_scope",
  "title": "Cheii API îi lipsește o permisiune",
  "status": 403,
  "detail": "Cheia nu are scope-ul operației.",
  "code": "insufficient_scope"
}

{
  "type": "https://worbo.app/docs/api/errors/not_found",
  "title": "Negăsit",
  "status": 404,
  "detail": "Resursa nu există sau aparține altei organizații.",
  "code": "not_found"
}

{
  "type": "https://worbo.app/docs/api/errors/idempotency_conflict",
  "title": "Idempotency-Key a fost folosită pentru altă cerere",
  "status": 409,
  "detail": "Idempotency-Key a fost folosit pentru altă cerere.",
  "code": "idempotency_conflict"
}

{
  "type": "https://worbo.app/docs/api/errors/validation_failed",
  "title": "Cererea nu este validă",
  "status": 422,
  "detail": "Un parametru lipsește, nu e valid sau nu e cunoscut; câmpul errors spune care.",
  "code": "validation_failed"
}

{
  "type": "https://worbo.app/docs/api/errors/rate_limited",
  "title": "Prea multe cereri",
  "status": 429,
  "detail": "Prea multe cereri; așteaptă secundele din Retry-After.",
  "code": "rate_limited"
}