Projetos

Criar e listar as competências de um projeto.

Rotas

método e rota	o que faz
POST /v1/api/projects/{projectId}/competencies	Create a new competency for the project using API
GET /v1/api/projects/{projectId}/competencies	Paginate project competencies using API

Listar as competências de um projeto

curl 'https://api.dynadok.com/v1/api/projects/6500a1b2c3d4e5f600000003/competencies' \
  --header 'x-api-key: 550e8400-e29b-41d4-a716-446655440000.SUA_CHAVE'

{
  "code": 200,
  "message": "OK",
  "timestamp": 1758585600000,
  "data": [
    {
      "_id": "6500a1b2c3d4e5f600000004",
      "publicTitle": "Admissão 2026.2",
      "competency": "2026.2",
      "startAt": "2026-09-01",
      "endAt": null
    }
  ],
  "meta": { "page": 1, "perPage": 20, "total": 1, "lastPage": 1 }
}

Criar uma competência

POST /v1/api/projects/{projectId}/competencies exige projectId, publicTitle (até 270 caracteres), allowParticipantRegister, enableSubmissionConclusion, allowAiDocumentSplit e competency. Também aceita startAt/endAt, aiDocumentSplitMaxPages, customFields, e um modo de clonagem a partir de outra competência via competencyIdToCopy + isToCopyDocuments/isToCopyFormula/isToCopyParticipants. A resposta traz a competência criada com documentGroups e documents já estruturados — formato completo, incluindo os campos aninhados, na Referência.

Erros típicos

Ver Envelope e erros. publicTitle acima de 270 caracteres, ou projectId inexistente, respondem 400/404 no formato descrito ali.