Grupo

INFO

• Observe que follow_up_possible pode não funcionar como esperado. Os valores possíveis são yes ou new_ticket!
• Se você quiser criar ou atualizar subgrupos, use :: como delimitador para os nomes. Você também precisa nomear a hierarquia completa no nome. Exemplo: Sales::Europe::South

Listar

Permissão necessária: admin.group

Solicitação GET enviada: /api/v1/groups

Details

// HTTP-Code 200 OK

[
  {
    "id": 1,
    "signature_id": 1,
    "email_address_id": null,
    "name": "Sales",
    "assignment_timeout": null,
    "follow_up_possible": "yes",
    "follow_up_assignment": true,
    "active": true,
    "note": "Standard Group/Pool for Tickets.",
    "updated_by_id": 1,
    "created_by_id": 1,
    "created_at": "2021-11-03T11:51:13.449Z",
    "updated_at": "2021-11-03T11:57:16.357Z",
    "user_ids": [
      3,
      4,
      5
    ]
  },
  {
    "id": 2,
    "signature_id": null,
    "email_address_id": null,
    "name": "Support::2nd Level",
    "assignment_timeout": null,
    "follow_up_possible": "yes",
    "follow_up_assignment": true,
    "active": true,
    "note": null,
    "updated_by_id": 1,
    "created_by_id": 1,
    "created_at": "2021-11-03T11:57:15.802Z",
    "updated_at": "2021-11-03T11:57:16.361Z",
    "user_ids": [
      3,
      4,
      5
    ]
  },
  {
    "id": 3,
    "signature_id": null,
    "email_address_id": null,
    "name": "IT Internal",
    "assignment_timeout": null,
    "follow_up_possible": "yes",
    "follow_up_assignment": true,
    "active": true,
    "note": null,
    "updated_by_id": 1,
    "created_by_id": 1,
    "created_at": "2021-11-03T11:57:15.807Z",
    "updated_at": "2021-11-03T11:57:16.365Z",
    "user_ids": [
      3,
      4,
      5
    ]
  }
]

Mostrar

Permissão necessária: admin.group

Solicitação GET enviada: /api/v1/groups/{id}

Details

// HTTP-Code 200 OK

{
  "id": 2,
  "signature_id": null,
  "email_address_id": null,
  "name": "2nd Level",
  "assignment_timeout": null,
  "follow_up_possible": "yes",
  "follow_up_assignment": true,
  "active": true,
  "note": null,
  "updated_by_id": 1,
  "created_by_id": 1,
  "created_at": "2021-11-03T11:57:15.802Z",
  "updated_at": "2021-11-03T11:57:16.361Z",
  "user_ids": [
    3,
    4,
    5
  ]
}

Criar

Permissão necessária: admin.group

Solicitação POST enviada: /api/v1/groups

Details

{
  "name": "Amazing Group",
  "signature_id": 1,
  "email_address_id": 3,
  "assignment_timeout": 180,
  "follow_up_possible": "new_ticket",
  "follow_up_assignment": false,
  "active": true,
  "note": "Look at my group, my group is amazing!"
}

Atualização

Permissão necessária: admin.group

Solicitação PUT enviada: /api/v1/groups/{id}

Details

{
  "name": "Amazing Group",
  "signature_id": 1,
  "email_address_id": 3,
  "assignment_timeout": 0,
  "follow_up_possible": "new_ticket",
  "follow_up_assignment": true,
  "active": true,
  "note": "Look at my group, my group is amazing!"
}

Excluir

Permissão necessária: admin.group

Solicitação DELETE enviada: /api/v1/groups/{id}

DANGER

Esta é uma remoção permanente:

Observe que remover grupos não pode ser desfeito.

Remover organizações com referências, por exemplo, em feeds de atividade ou tickets, não é possível via API - isso será indicado por "error": "Can't delete, object has references.". Isso não é um bug.

Considere definir os grupos afetados como inativos, ou garanta mover todos os tickets existentes para novos grupos.

Details

// HTTP-Code 200 OK

{}