Axuz Developers

POST /teams/{teamId}/tasks/{id}/external-assignees

Atribui a task a uma pessoa externa

  • Acesso: Membro da equipe
  • Serviço: https://api-workspace.axuz.net

Autenticação aceita

  • sessionCookie — Sessão plena Axuz (cookie de sessão da casa). Sessão restrita é 403 enrollment_required.
  • bearerSession — JWT de acesso da sessão em `Authorization: Bearer`.

Maximo de 25 externos ativos por task (422 too many external assignees). Emite o evento task.external_assignee.added.

Parâmetros

NomeEmTipoObrigatórioDescrição
teamIdpathstringsim
idpathstringsim

No servico o segmento e {id}; o nome aqui e so descritivo.

Corpo da requisição

application/json · Obrigatório

NomeTipoObrigatórioDescrição
namestringsim

Apos trim; contado em caracteres.

organizationstring | nullnão
show_on_publicbooleannão
{
  "name": "string",
  "organization": "string",
  "show_on_public": true
}

Respostas

201

Criado.

NomeTipoObrigatórioDescrição
idstring<uuid>sim
task_idstring<uuid>sim
namestringsim
organizationstring | nullsim
show_on_publicbooleansim
created_bystring<uuid>sim
created_atstring<date-time>sim

400

Erro no formato do servico.

NomeTipoObrigatórioDescrição
errorstringsim

401

Erro no formato do servico.

NomeTipoObrigatórioDescrição
errorstringsim

403

Erro no formato do servico.

NomeTipoObrigatórioDescrição
errorstringsim

404

Erro no formato do servico.

NomeTipoObrigatórioDescrição
errorstringsim

422

Erro no formato do servico.

NomeTipoObrigatórioDescrição
errorstringsim

429

Rate limit.

NomeTipoObrigatórioDescrição
errorstringsim
retry_afterintegersim

500

Erro interno. Tente de novo com backoff; reporte o X-Request-Id.

NomeTipoObrigatórioDescrição
errorstringsim

Exemplos

O "Try it" está desligado nesta referência. Use os exemplos com a sua credencial de teste.

curl

curl -sS -X POST 'https://api-workspace.axuz.net/teams/TEAM_ID/tasks/ID/external-assignees' \
  -H "Authorization: Bearer $AXUZ_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"string","organization":"string","show_on_public":true}'

Node.js

const res = await fetch("https://api-workspace.axuz.net/teams/TEAM_ID/tasks/ID/external-assignees", {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.AXUZ_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "string",
    "organization": "string",
    "show_on_public": true
  }),
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
console.log(await res.json());

Python

import os
import requests

res = requests.request(
    "POST",
    "https://api-workspace.axuz.net/teams/TEAM_ID/tasks/ID/external-assignees",
    headers={
        "Authorization": f"Bearer {os.environ['AXUZ_TOKEN']}",
    },
    json={
        "name": "string",
        "organization": "string",
        "show_on_public": True,
    },
    timeout=30,
)
res.raise_for_status()
print(res.json())