Catalog

18 endpoint-uri. Fiecare cale de mai jos este relativă la URL-ul de bază al API-ului și include deja prefixul /api/v1 — vezi convențiile pentru autentificare, paginare, erori și idempotență.

	Endpoint
GET	`/contact-center/dispositions`	List the active call dispositions agents can pick during wrap-up
POST	`/contact-center/dispositions`	Create a wrap-up disposition, deriving its code from the name when none is given
DELETE	`/contact-center/dispositions/{id}`	Delete a wrap-up disposition from the tenant's catalogue
GET	`/contact-center/ivrs`	List the tenant's IVR flows with their published and draft version pointers
POST	`/contact-center/ivrs`	Create an IVR flow together with its first empty draft version
GET	`/contact-center/ivrs/{id}`	Fetch one IVR with its version history and the graph of the currently live version
POST	`/contact-center/ivrs/{id}/publish`	Publish the IVR's draft version so live calls start using it, refusing an invalid flow
POST	`/contact-center/ivrs/{id}/validate`	Validation errors are data, not exceptions: the builder renders them inline
POST	`/contact-center/operators/{operatorId}/skills`	Assign a skill to an operator at a given proficiency, updating the assignment if it already exists
POST	`/contact-center/queues/{queueId}/members`	Add an operator to a queue with a penalty and priority, or update the existing membership
DELETE	`/contact-center/queues/{queueId}/members/{operatorId}`	Remove an operator from a queue's membership list
POST	`/contact-center/queues/{queueId}/members/{operatorId}/pause`	Pause or unpause an operator in one queue, recording the pause reason and timestamp
GET	`/contact-center/ring-groups`	List the tenant's ring groups with their strategy, ring timeout and member counts
POST	`/contact-center/ring-groups`	Create a ring group with a generated slug and return its id, name and slug
PATCH	`/contact-center/ring-groups/{id}`	Update a ring group's name, extension, strategy or ring timings
DELETE	`/contact-center/ring-groups/{id}`	Delete a ring group
GET	`/contact-center/skills`	List the tenant's active routing skills with their category and maximum proficiency
POST	`/contact-center/skills`	Create a routing skill with a generated slug and return its id and slug

Endpoint-uri

List the active call dispositions agents can pick during wrap-up

GET/contact-center/dispositions

Handler-ul nu impune niciun scope — orice cheie validă îl poate apela.
Inactive dispositions are never returned and there is no query parameter to include them.

cURLJavaScriptPHPPython

bash

curl -X GET "$CALLAGENT_API_URL/contact-center/dispositions" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Accept: application/json"

const response = await fetch(`${process.env.CALLAGENT_API_URL}/contact-center/dispositions`, {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
  },
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/contact-center/dispositions');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
    ],
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.get(
    f"{os.environ['CALLAGENT_API_URL']}/contact-center/dispositions",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`200`	`data`-wrapped array

Exemplu de răspuns, generat din schemă:

json

{
  "data": {},
  "meta": {
    "page": 1,
    "limit": 25,
    "total": 1,
    "pages": 1
  }
}

Create a wrap-up disposition, deriving its code from the name when none is given

POST/contact-center/dispositions

Necesită queue.write.
Returns 201 with a minimal body of id and code only, not the full disposition.

Corpul cererii

Câmp	Tip	Obligatoriu	Note
`name`	string	da	max 255 chars
`code`	string \| null	—	max 48 chars
`outcome`	`resolved` · `unresolved` · `escalated` · `callback_scheduled` · `sale` · `no_sale` …	da
`description`	string \| null	—	max 255 chars
`requires_note`	boolean \| null	—
`schedules_callback`	boolean \| null	—
`ends_wrap_up`	boolean \| null	—
`queue_ids`	string[] \| null	—
`position`	integer \| null	—	min 0

cURLJavaScriptPHPPython

bash

curl -X POST "$CALLAGENT_API_URL/contact-center/dispositions" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
       "name": "Support Line",
       "outcome": "resolved",
       "requires_note": true,
       "schedules_callback": true,
       "ends_wrap_up": true,
       "position": 1
     }'

const response = await fetch(`${process.env.CALLAGENT_API_URL}/contact-center/dispositions`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Support Line",
    "outcome": "resolved",
    "requires_note": true,
    "schedules_callback": true,
    "ends_wrap_up": true,
    "position": 1
  }),
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/contact-center/dispositions');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
    'name' => 'Support Line',
    'outcome' => 'resolved',
    'requires_note' => true,
    'schedules_callback' => true,
    'ends_wrap_up' => true,
    'position' => 1,
]),
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.post(
    f"{os.environ['CALLAGENT_API_URL']}/contact-center/dispositions",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    json={
      "name": "Support Line",
      "outcome": "resolved",
      "requires_note": True,
      "schedules_callback": True,
      "ends_wrap_up": True,
      "position": 1
    },
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`200`	JSON object

Erori

Status	Când apare
`403`	Session user lacks the queue.write permission
`422`	Validation failed; name and a known outcome are required

Delete a wrap-up disposition from the tenant's catalogue

DELETE/contact-center/dispositions/{id}

Necesită queue.write.
Acest răspuns nu este împachetat în data.

Parametri de cale

Nume	Tip	Obligatoriu	Note
`id`	string	da

cURLJavaScriptPHPPython

bash

curl -X DELETE "$CALLAGENT_API_URL/contact-center/dispositions/01JQ0000000000000000000000" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Accept: application/json"

const response = await fetch(`${process.env.CALLAGENT_API_URL}/contact-center/dispositions/01JQ0000000000000000000000`, {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
  },
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/contact-center/dispositions/01JQ0000000000000000000000');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
    ],
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.delete(
    f"{os.environ['CALLAGENT_API_URL']}/contact-center/dispositions/01JQ0000000000000000000000",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`200`	Bare JSON object, not `data`-wrapped

Erori

Status	Când apare
`403`	Session user lacks the queue.write permission
`404`	No disposition with this id in the caller's tenant

List the tenant's IVR flows with their published and draft version pointers

GET/contact-center/ivrs

Handler-ul nu impune niciun scope — orice cheie validă îl poate apela.

cURLJavaScriptPHPPython

bash

curl -X GET "$CALLAGENT_API_URL/contact-center/ivrs" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Accept: application/json"

const response = await fetch(`${process.env.CALLAGENT_API_URL}/contact-center/ivrs`, {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
  },
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/contact-center/ivrs');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
    ],
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.get(
    f"{os.environ['CALLAGENT_API_URL']}/contact-center/ivrs",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`200`	`data`-wrapped array

Exemplu de răspuns, generat din schemă:

json

{
  "data": {},
  "meta": {
    "page": 1,
    "limit": 25,
    "total": 1,
    "pages": 1
  }
}

Create an IVR flow together with its first empty draft version

POST/contact-center/ivrs

Necesită ivr.write.
Returns 201. The slug is always generated from the name; a client-supplied slug is ignored.

Corpul cererii

Câmp	Tip	Obligatoriu	Note
`name`	string	da	max 255 chars
`description`	string \| null	—	max 255 chars
`extension`	string \| null	—	max 24 chars
`language`	string \| null	—	max 16 chars

cURLJavaScriptPHPPython

bash

curl -X POST "$CALLAGENT_API_URL/contact-center/ivrs" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
       "name": "Support Line"
     }'

const response = await fetch(`${process.env.CALLAGENT_API_URL}/contact-center/ivrs`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Support Line"
  }),
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/contact-center/ivrs');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
    'name' => 'Support Line',
]),
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.post(
    f"{os.environ['CALLAGENT_API_URL']}/contact-center/ivrs",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    json={
      "name": "Support Line"
    },
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`200`	JSON object

Erori

Status	Când apare
`403`	Session user lacks the ivr.write permission
`422`	Validation failed; name is required

Fetch one IVR with its version history and the graph of the currently live version

GET/contact-center/ivrs/{id}

Handler-ul nu impune niciun scope — orice cheie validă îl poate apela.

Parametri de cale

Nume	Tip	Obligatoriu	Note
`id`	string	da

cURLJavaScriptPHPPython

bash

curl -X GET "$CALLAGENT_API_URL/contact-center/ivrs/01JQ0000000000000000000000" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Accept: application/json"

const response = await fetch(`${process.env.CALLAGENT_API_URL}/contact-center/ivrs/01JQ0000000000000000000000`, {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
  },
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/contact-center/ivrs/01JQ0000000000000000000000');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
    ],
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.get(
    f"{os.environ['CALLAGENT_API_URL']}/contact-center/ivrs/01JQ0000000000000000000000",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`200`	`data`-wrapped object

Erori

Status	Când apare
`404`	No IVR with this id in the caller's tenant

Exemplu de răspuns, generat din schemă:

json

{
  "data": {
    "id": null,
    "name": "Support Line",
    "slug": "string",
    "is_active": true,
    "versions": [
      {}
    ],
    "live_graph": {}
  }
}

Publish the IVR's draft version so live calls start using it, refusing an invalid flow

POST/contact-center/ivrs/{id}/publish

Necesită ivr.write.
An IVR that exists but has no draft returns 404 ('IVR draft not found'), not 409.

Parametri de cale

Nume	Tip	Obligatoriu	Note
`id`	string	da

cURLJavaScriptPHPPython

bash

curl -X POST "$CALLAGENT_API_URL/contact-center/ivrs/01JQ0000000000000000000000/publish" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Accept: application/json"

const response = await fetch(`${process.env.CALLAGENT_API_URL}/contact-center/ivrs/01JQ0000000000000000000000/publish`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
  },
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/contact-center/ivrs/01JQ0000000000000000000000/publish');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
    ],
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.post(
    f"{os.environ['CALLAGENT_API_URL']}/contact-center/ivrs/01JQ0000000000000000000000/publish",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`200`	JSON object

Erori

Status	Când apare
`403`	Session user lacks the ivr.write permission
`404`	No IVR with this id, or the IVR has no draft version
`422`	The draft is not valid, or the version is not in draft status

Validation errors are data, not exceptions: the builder renders them inline

POST/contact-center/ivrs/{id}/validate

Handler-ul nu impune niciun scope — orice cheie validă îl poate apela.
An invalid draft is still a 200: read the valid flag and errors array rather than the status code.

Parametri de cale

Nume	Tip	Obligatoriu	Note
`id`	string	da

cURLJavaScriptPHPPython

bash

curl -X POST "$CALLAGENT_API_URL/contact-center/ivrs/01JQ0000000000000000000000/validate" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Accept: application/json"

const response = await fetch(`${process.env.CALLAGENT_API_URL}/contact-center/ivrs/01JQ0000000000000000000000/validate`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
  },
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/contact-center/ivrs/01JQ0000000000000000000000/validate');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
    ],
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.post(
    f"{os.environ['CALLAGENT_API_URL']}/contact-center/ivrs/01JQ0000000000000000000000/validate",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`200`	`data`-wrapped object

Erori

Status	Când apare
`404`	No IVR with this id, or the IVR has no draft version

Exemplu de răspuns, generat din schemă:

json

{
  "data": {
    "valid": true,
    "errors": [
      "string"
    ]
  }
}

Assign a skill to an operator at a given proficiency, updating the assignment if it already exists

POST/contact-center/operators/{operatorId}/skills

Necesită operator.write.
Upsert semantics: re-posting the same skill_id overwrites proficiency (default 3) and expires_at instead of erroring.

Parametri de cale

Nume	Tip	Obligatoriu	Note
`operatorId`	string	da

Corpul cererii

Câmp	Tip	Obligatoriu	Note
`skill_id`	string	da
`proficiency`	integer \| null	—	min 1. max 10
`expires_at`	string \| null	—	date-time

cURLJavaScriptPHPPython

bash

curl -X POST "$CALLAGENT_API_URL/contact-center/operators/01JQ0000000000000000000000/skills" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
       "skill_id": "01JQ0000000000000000000000",
       "proficiency": 1,
       "expires_at": "2026-01-01T12:00:00+00:00"
     }'

const response = await fetch(`${process.env.CALLAGENT_API_URL}/contact-center/operators/01JQ0000000000000000000000/skills`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "skill_id": "01JQ0000000000000000000000",
    "proficiency": 1,
    "expires_at": "2026-01-01T12:00:00+00:00"
  }),
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/contact-center/operators/01JQ0000000000000000000000/skills');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
    'skill_id' => '01JQ0000000000000000000000',
    'proficiency' => 1,
    'expires_at' => '2026-01-01T12:00:00+00:00',
]),
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.post(
    f"{os.environ['CALLAGENT_API_URL']}/contact-center/operators/01JQ0000000000000000000000/skills",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    json={
      "skill_id": "01JQ0000000000000000000000",
      "proficiency": 1,
      "expires_at": "2026-01-01T12:00:00+00:00"
    },
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`200`	JSON object

Erori

Status	Când apare
`403`	Session user lacks the operator.write permission
`404`	No operator with this id in the caller's tenant
`422`	skill_id is missing or does not reference an existing skill

Add an operator to a queue with a penalty and priority, or update the existing membership

POST/contact-center/queues/{queueId}/members

Necesită queue.write.
Returns 201 even when it updated an existing membership; joined_at is reset to now on every call.

Parametri de cale

Nume	Tip	Obligatoriu	Note
`queueId`	string	da

Corpul cererii

Câmp	Tip	Obligatoriu	Note
`operator_id`	string	da
`penalty`	integer \| null	—	min 0. max 100
`priority`	integer \| null	—	min 0. max 1000
`membership`	`static` · `dynamic` · `null` \| null	—

cURLJavaScriptPHPPython

bash

curl -X POST "$CALLAGENT_API_URL/contact-center/queues/01JQ0000000000000000000000/members" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
       "operator_id": "01JQ0000000000000000000000",
       "penalty": 1,
       "priority": 1,
       "membership": "static"
     }'

const response = await fetch(`${process.env.CALLAGENT_API_URL}/contact-center/queues/01JQ0000000000000000000000/members`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "operator_id": "01JQ0000000000000000000000",
    "penalty": 1,
    "priority": 1,
    "membership": "static"
  }),
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/contact-center/queues/01JQ0000000000000000000000/members');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
    'operator_id' => '01JQ0000000000000000000000',
    'penalty' => 1,
    'priority' => 1,
    'membership' => 'static',
]),
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.post(
    f"{os.environ['CALLAGENT_API_URL']}/contact-center/queues/01JQ0000000000000000000000/members",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    json={
      "operator_id": "01JQ0000000000000000000000",
      "penalty": 1,
      "priority": 1,
      "membership": "static"
    },
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`200`	JSON object

Erori

Status	Când apare
`403`	Session user lacks the queue.write permission
`404`	No queue with this id in the caller's tenant
`422`	operator_id is missing or does not reference an existing operator

Remove an operator from a queue's membership list

DELETE/contact-center/queues/{queueId}/members/{operatorId}

Necesită queue.write.
Acest răspuns nu este împachetat în data.

Parametri de cale

Nume	Tip	Obligatoriu	Note
`queueId`	string	da
`operatorId`	string	da

cURLJavaScriptPHPPython

bash

curl -X DELETE "$CALLAGENT_API_URL/contact-center/queues/01JQ0000000000000000000000/members/01JQ0000000000000000000000" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Accept: application/json"

const response = await fetch(`${process.env.CALLAGENT_API_URL}/contact-center/queues/01JQ0000000000000000000000/members/01JQ0000000000000000000000`, {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
  },
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/contact-center/queues/01JQ0000000000000000000000/members/01JQ0000000000000000000000');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
    ],
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.delete(
    f"{os.environ['CALLAGENT_API_URL']}/contact-center/queues/01JQ0000000000000000000000/members/01JQ0000000000000000000000",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`200`	Bare JSON object, not `data`-wrapped

Erori

Status	Când apare
`403`	Session user lacks the queue.write permission
`404`	That operator is not a member of that queue

Pause or unpause an operator in one queue, recording the pause reason and timestamp

POST/contact-center/queues/{queueId}/members/{operatorId}/pause

Handler-ul nu impune niciun scope — orice cheie validă îl poate apela.
Enforces no permission at all, unlike the sibling member add/remove routes. Body fields paused (default true) and reason are unvalidated.

Parametri de cale

Nume	Tip	Obligatoriu	Note
`queueId`	string	da
`operatorId`	string	da

Corpul cererii

Câmp	Tip	Obligatoriu	Note
`paused`	boolean	—	default `true`

cURLJavaScriptPHPPython

bash

curl -X POST "$CALLAGENT_API_URL/contact-center/queues/01JQ0000000000000000000000/members/01JQ0000000000000000000000/pause" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
       "paused": true
     }'

const response = await fetch(`${process.env.CALLAGENT_API_URL}/contact-center/queues/01JQ0000000000000000000000/members/01JQ0000000000000000000000/pause`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "paused": true
  }),
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/contact-center/queues/01JQ0000000000000000000000/members/01JQ0000000000000000000000/pause');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
    'paused' => true,
]),
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.post(
    f"{os.environ['CALLAGENT_API_URL']}/contact-center/queues/01JQ0000000000000000000000/members/01JQ0000000000000000000000/pause",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    json={
      "paused": True
    },
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`200`	`data`-wrapped object

Erori

Status	Când apare
`404`	That operator is not a member of that queue

Exemplu de răspuns, generat din schemă:

json

{
  "data": {
    "id": null,
    "is_paused": true
  }
}

List the tenant's ring groups with their strategy, ring timeout and member counts

GET/contact-center/ring-groups

Handler-ul nu impune niciun scope — orice cheie validă îl poate apela.

cURLJavaScriptPHPPython

bash

curl -X GET "$CALLAGENT_API_URL/contact-center/ring-groups" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Accept: application/json"

const response = await fetch(`${process.env.CALLAGENT_API_URL}/contact-center/ring-groups`, {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
  },
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/contact-center/ring-groups');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
    ],
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.get(
    f"{os.environ['CALLAGENT_API_URL']}/contact-center/ring-groups",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`200`	`data`-wrapped array

Exemplu de răspuns, generat din schemă:

json

{
  "data": {},
  "meta": {
    "page": 1,
    "limit": 25,
    "total": 1,
    "pages": 1
  }
}

Create a ring group with a generated slug and return its id, name and slug

POST/contact-center/ring-groups

Necesită extension.write.
Guarded by extension.write, not a ring-group-specific permission. Returns 201 with a minimal body.

Corpul cererii

Câmp	Tip	Obligatoriu	Note
`name`	string	da	max 255 chars
`extension`	string \| null	—	max 24 chars
`strategy`	`simultaneous` · `sequential` · `round_robin` · `random` · `null` \| null	—
`ring_timeout_seconds`	integer \| null	—	min 5. max 300
`member_ring_seconds`	integer \| null	—	min 5. max 120
`confirm_answer`	boolean \| null	—
`skip_busy_members`	boolean \| null	—

cURLJavaScriptPHPPython

bash

curl -X POST "$CALLAGENT_API_URL/contact-center/ring-groups" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
       "name": "Support Line",
       "strategy": "simultaneous",
       "ring_timeout_seconds": 30,
       "member_ring_seconds": 30,
       "confirm_answer": true,
       "skip_busy_members": true
     }'

const response = await fetch(`${process.env.CALLAGENT_API_URL}/contact-center/ring-groups`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Support Line",
    "strategy": "simultaneous",
    "ring_timeout_seconds": 30,
    "member_ring_seconds": 30,
    "confirm_answer": true,
    "skip_busy_members": true
  }),
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/contact-center/ring-groups');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
    'name' => 'Support Line',
    'strategy' => 'simultaneous',
    'ring_timeout_seconds' => 30,
    'member_ring_seconds' => 30,
    'confirm_answer' => true,
    'skip_busy_members' => true,
]),
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.post(
    f"{os.environ['CALLAGENT_API_URL']}/contact-center/ring-groups",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    json={
      "name": "Support Line",
      "strategy": "simultaneous",
      "ring_timeout_seconds": 30,
      "member_ring_seconds": 30,
      "confirm_answer": True,
      "skip_busy_members": True
    },
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`200`	JSON object

Erori

Status	Când apare
`403`	Session user lacks the extension.write permission
`422`	Validation failed; name is required

Update a ring group's name, extension, strategy or ring timings

PATCH/contact-center/ring-groups/{id}

Necesită extension.write.
The response is only id and name; confirm_answer and skip_busy_members are accepted on create but not on update.

Parametri de cale

Nume	Tip	Obligatoriu	Note
`id`	string	da

Corpul cererii

Câmp	Tip	Obligatoriu	Note
`name`	string	—	max 255 chars
`extension`	string \| null	—	max 24 chars
`strategy`	`simultaneous` · `sequential` · `round_robin` · `random` · `null` \| null	—
`ring_timeout_seconds`	integer \| null	—	min 5. max 300
`member_ring_seconds`	integer \| null	—	min 5. max 120
`is_active`	boolean \| null	—

cURLJavaScriptPHPPython

bash

curl -X PATCH "$CALLAGENT_API_URL/contact-center/ring-groups/01JQ0000000000000000000000" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
       "name": "Support Line",
       "strategy": "simultaneous",
       "ring_timeout_seconds": 30,
       "member_ring_seconds": 30,
       "is_active": true
     }'

const response = await fetch(`${process.env.CALLAGENT_API_URL}/contact-center/ring-groups/01JQ0000000000000000000000`, {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Support Line",
    "strategy": "simultaneous",
    "ring_timeout_seconds": 30,
    "member_ring_seconds": 30,
    "is_active": true
  }),
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/contact-center/ring-groups/01JQ0000000000000000000000');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'PATCH',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
    'name' => 'Support Line',
    'strategy' => 'simultaneous',
    'ring_timeout_seconds' => 30,
    'member_ring_seconds' => 30,
    'is_active' => true,
]),
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.patch(
    f"{os.environ['CALLAGENT_API_URL']}/contact-center/ring-groups/01JQ0000000000000000000000",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    json={
      "name": "Support Line",
      "strategy": "simultaneous",
      "ring_timeout_seconds": 30,
      "member_ring_seconds": 30,
      "is_active": True
    },
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`200`	JSON object

Erori

Status	Când apare
`403`	Session user lacks the extension.write permission
`404`	No ring group with this id in the caller's tenant
`422`	Validation failed on the ring group payload

Delete a ring group

DELETE/contact-center/ring-groups/{id}

Necesită extension.write.
Acest răspuns nu este împachetat în data.

Parametri de cale

Nume	Tip	Obligatoriu	Note
`id`	string	da

cURLJavaScriptPHPPython

bash

curl -X DELETE "$CALLAGENT_API_URL/contact-center/ring-groups/01JQ0000000000000000000000" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Accept: application/json"

const response = await fetch(`${process.env.CALLAGENT_API_URL}/contact-center/ring-groups/01JQ0000000000000000000000`, {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
  },
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/contact-center/ring-groups/01JQ0000000000000000000000');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
    ],
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.delete(
    f"{os.environ['CALLAGENT_API_URL']}/contact-center/ring-groups/01JQ0000000000000000000000",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`200`	Bare JSON object, not `data`-wrapped

Erori

Status	Când apare
`403`	Session user lacks the extension.write permission
`404`	No ring group with this id in the caller's tenant

List the tenant's active routing skills with their category and maximum proficiency

GET/contact-center/skills

Handler-ul nu impune niciun scope — orice cheie validă îl poate apela.

cURLJavaScriptPHPPython

bash

curl -X GET "$CALLAGENT_API_URL/contact-center/skills" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Accept: application/json"

const response = await fetch(`${process.env.CALLAGENT_API_URL}/contact-center/skills`, {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
  },
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/contact-center/skills');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
    ],
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.get(
    f"{os.environ['CALLAGENT_API_URL']}/contact-center/skills",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`200`	`data`-wrapped array

Exemplu de răspuns, generat din schemă:

json

{
  "data": {},
  "meta": {
    "page": 1,
    "limit": 25,
    "total": 1,
    "pages": 1
  }
}

Create a routing skill with a generated slug and return its id and slug

POST/contact-center/skills

Necesită operator.write.
Guarded by operator.write. category is limited to general, language, product, tier or certification.

Corpul cererii

Câmp	Tip	Obligatoriu	Note
`name`	string	da	max 255 chars
`category`	`general` · `language` · `product` · `tier` · `certification` · `null` \| null	—
`language_tag`	string \| null	—	max 16 chars
`max_proficiency`	integer \| null	—	min 1. max 10
`description`	string \| null	—	max 255 chars

cURLJavaScriptPHPPython

bash

curl -X POST "$CALLAGENT_API_URL/contact-center/skills" \
  -H "Authorization: Bearer $CALLAGENT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
       "name": "Support Line",
       "category": "general",
       "max_proficiency": 1
     }'

const response = await fetch(`${process.env.CALLAGENT_API_URL}/contact-center/skills`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.CALLAGENT_API_KEY}`,
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Support Line",
    "category": "general",
    "max_proficiency": 1
  }),
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(`${error.type}: ${error.message}`);
}

const { data } = await response.json();

php

<?php

$handle = curl_init(getenv('CALLAGENT_API_URL') . '/contact-center/skills');

curl_setopt_array($handle, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CALLAGENT_API_KEY'),
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
    'name' => 'Support Line',
    'category' => 'general',
    'max_proficiency' => 1,
]),
]);

$body = json_decode(curl_exec($handle), true);
$status = curl_getinfo($handle, CURLINFO_HTTP_CODE);
curl_close($handle);

if ($status >= 400) {
    throw new RuntimeException("{$body['error']['type']}: {$body['error']['message']}");
}

$data = $body['data'];

python

import os, requests

response = requests.post(
    f"{os.environ['CALLAGENT_API_URL']}/contact-center/skills",
    headers={"Authorization": f"Bearer {os.environ['CALLAGENT_API_KEY']}"},
    json={
      "name": "Support Line",
      "category": "general",
      "max_proficiency": 1
    },
    timeout=30,
)
response.raise_for_status()
data = response.json()["data"]

Răspunsuri

Status	Corp
`200`	JSON object

Erori

Status	Când apare
`403`	Session user lacks the operator.write permission
`422`	Validation failed; name is required and category must be a known value

Catalog ​

Endpoint-uri ​

List the active call dispositions agents can pick during wrap-up ​

Create a wrap-up disposition, deriving its code from the name when none is given ​

Delete a wrap-up disposition from the tenant's catalogue ​

List the tenant's IVR flows with their published and draft version pointers ​

Create an IVR flow together with its first empty draft version ​

Fetch one IVR with its version history and the graph of the currently live version ​

Publish the IVR's draft version so live calls start using it, refusing an invalid flow ​

Validation errors are data, not exceptions: the builder renders them inline ​

Assign a skill to an operator at a given proficiency, updating the assignment if it already exists ​

Add an operator to a queue with a penalty and priority, or update the existing membership ​

Remove an operator from a queue's membership list ​

Pause or unpause an operator in one queue, recording the pause reason and timestamp ​

List the tenant's ring groups with their strategy, ring timeout and member counts ​

Create a ring group with a generated slug and return its id, name and slug ​

Update a ring group's name, extension, strategy or ring timings ​

Delete a ring group ​

List the tenant's active routing skills with their category and maximum proficiency ​

Create a routing skill with a generated slug and return its id and slug ​

Catalog

Endpoint-uri

List the active call dispositions agents can pick during wrap-up

Create a wrap-up disposition, deriving its code from the name when none is given

Delete a wrap-up disposition from the tenant's catalogue

List the tenant's IVR flows with their published and draft version pointers

Create an IVR flow together with its first empty draft version

Fetch one IVR with its version history and the graph of the currently live version

Publish the IVR's draft version so live calls start using it, refusing an invalid flow

Validation errors are data, not exceptions: the builder renders them inline

Assign a skill to an operator at a given proficiency, updating the assignment if it already exists

Add an operator to a queue with a penalty and priority, or update the existing membership

Remove an operator from a queue's membership list

Pause or unpause an operator in one queue, recording the pause reason and timestamp

List the tenant's ring groups with their strategy, ring timeout and member counts

Create a ring group with a generated slug and return its id, name and slug

Update a ring group's name, extension, strategy or ring timings

Delete a ring group

List the tenant's active routing skills with their category and maximum proficiency

Create a routing skill with a generated slug and return its id and slug