> ## Documentation Index
> Fetch the complete documentation index at: https://developers.tarefy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cria um projeto dentro de um time

> Cria um projeto em um time da conta autenticada. Informe o ID do time em team ou teamId. Opcionalmente, aplique um template ou indique uma pasta do time.



## OpenAPI

````yaml /api-reference/tarefas.yaml post /v2/projects
openapi: 3.0.0
info:
  title: Tarefy API
  description: >-
    Tarefy REST API — platform for team management, tasks, culture, and
    performance.


    Versioned endpoints are available under `/v2/...`. Authenticate with a
    Bearer JWT in the `Authorization` header.


    To get started, see the [authentication guide](/authentication) and the
    [quickstart](/quickstart).
  version: 2.0.0
  contact:
    name: Tarefy Support
    email: suporte@tarefy.com
    url: https://tarefy.com
  license:
    name: Proprietary
servers:
  - url: https://app.tarefy.com/nodeapi
    description: Production
security:
  - bearerAuth: []
tags: []
paths:
  /v2/projects:
    post:
      tags:
        - Projects
      summary: Cria um projeto dentro de um time
      description: >-
        Cria um projeto em um time da conta autenticada. Informe o ID do time em
        team ou teamId. Opcionalmente, aplique um template ou indique uma pasta
        do time.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - name
                - color
              anyOf:
                - required:
                    - team
                - required:
                    - teamId
              properties:
                name:
                  type: string
                  minLength: 1
                  description: Nome do novo projeto.
                  example: Projeto de exemplo
                color:
                  type: string
                  minLength: 1
                  description: Cor do projeto, normalmente em hexadecimal.
                  example: '#3B82F6'
                team:
                  type: integer
                  minimum: 1
                  description: ID do time da conta. Tem precedência sobre teamId.
                  example: 42
                teamId:
                  type: integer
                  minimum: 1
                  description: Alias de team; use quando team não for informado.
                templateId:
                  type: string
                  description: >-
                    ID numérico do template da conta ou ID textual de um
                    template do Tarefy.
                isTarefyTemplate:
                  type: boolean
                  description: >-
                    Envie true para aplicar um template do Tarefy com ID
                    textual.
                folderId:
                  type: integer
                  minimum: 1
                  maximum: 2147483647
                  description: >-
                    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".
            example:
              name: Projeto de exemplo
              color: '#3B82F6'
              teamId: 42
      responses:
        '201':
          description: >-
            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.
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - message
                properties:
                  status:
                    type: boolean
                  message:
                    type: string
                  data:
                    type: object
                    additionalProperties: true
                    description: Registro criado; presente somente em caso de sucesso.
                    properties:
                      id:
                        type: integer
                      name:
                        type: string
                      color:
                        type: string
                        nullable: true
                      team:
                        type: integer
                        nullable: true
                  project:
                    type: object
                    additionalProperties: true
                    description: Alias de data; presente somente em caso de sucesso.
              examples:
                success:
                  summary: Projeto criado (IDs ilustrativos)
                  value:
                    status: true
                    message: Projeto criado com sucesso
                    data:
                      id: 1234
                      name: Projeto de exemplo
                      color: '#3B82F6'
                      team: 42
                    project:
                      id: 1234
                      name: Projeto de exemplo
                      color: '#3B82F6'
                      team: 42
                invalidTeam:
                  summary: Time não encontrado na conta
                  value:
                    status: false
                    message: >-
                      Time não encontrado ou você não tem permissão para
                      acessá-lo.
        '400':
          description: Falha de validação do DTO (nome, cor ou tipos dos campos inválidos).
        '401':
          description: Token ausente ou inválido.
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: |-
        JWT token obtained from `/v2/auth/login`. Send it in the header:
        `Authorization: Bearer <your_token>`

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.