Skip to main content
POST
Cria um projeto dentro de um time

Authorizations

Authorization
string
header
required

JWT token obtained from /v2/auth/login. Send it in the header: Authorization: Bearer <your_token>

Body

application/json
name
string
required

Nome do novo projeto.

Minimum string length: 1
Example:

"Projeto de exemplo"

color
string
required

Cor do projeto, normalmente em hexadecimal.

Minimum string length: 1
Example:

"#3B82F6"

team
integer
required

ID do time da conta. Tem precedência sobre teamId.

Required range: x >= 1
Example:

42

teamId
integer

Alias de team; use quando team não for informado.

Required range: x >= 1
templateId
string

ID numérico do template da conta ou ID textual de um template do Tarefy.

isTarefyTemplate
boolean

Envie true para aplicar um template do Tarefy com ID textual.

folderId
integer

Pasta do time onde o projeto já nasce (topo da pasta). Exige ser dono do time ou ter a permissão de organizar pastas (10037). Pasta de outro time, inexistente ou "Sem pasta" recusa a criação antes de gravar o projeto. Se o posicionamento falhar após a criação, o projeto permanece criado, em "Sem pasta".

Required range: 1 <= x <= 2147483647

Response

Resultado da criação. status true indica sucesso; data e project contêm o mesmo registro criado. status false indica erro do serviço (dados incompletos, time ou template não encontrado, pasta inválida ou falta de permissão), com a mensagem no corpo.

status
boolean
required
message
string
required
data
object

Registro criado; presente somente em caso de sucesso.

project
object

Alias de data; presente somente em caso de sucesso.