---
updatedAt: 2026-06-11T21:38:37.000Z
agentTools:
  projectIndex: https://docs.atono.io/llms.txt
---

# Create a team

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Atono API",
    "version": "0.1"
  },
  "servers": [
    {
      "url": "https://api.atono.io",
      "description": "Atono API"
    }
  ],
  "security": [
    {
      "ApiKeyAuth": []
    }
  ],
  "paths": {
    "/api/v1/teams": {
      "post": {
        "tags": [
          "Teams"
        ],
        "summary": "Create a team",
        "operationId": "createTeam_1",
        "requestBody": {
          "description": "The team to create.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Request_TeamCreateResourceV1_"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successfully created the team.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SingleResourceBody_TeamResourceV1_"
                }
              }
            },
            "links": {
              "self": {
                "operationId": "fetchTeam",
                "parameters": {
                  "id": "$response.body#/data/id"
                }
              },
              "update": {
                "operationId": "updateTeam",
                "parameters": {
                  "id": "$response.body#/data/id"
                }
              },
              "delete": {
                "operationId": "deleteTeam",
                "parameters": {
                  "id": "$response.body#/data/id"
                }
              }
            }
          },
          "403": {
            "description": "The authenticated user does not have permission to create a new team.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NoResourceBody"
                }
              }
            }
          },
          "404": {
            "description": "One of the team's relationships was not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NoResourceBody"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "MultipleRelationships": {
        "properties": {
          "links": {
            "$ref": "#/components/schemas/RelationshipLinks"
          },
          "data": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/ResourceIdentifier"
            }
          },
          "meta": {
            "additionalProperties": true
          }
        },
        "required": [
          "data",
          "links",
          "meta"
        ]
      },
      "MultipleRelationshipsUpdate": {
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ResourceIdentifier"
            }
          }
        },
        "required": [
          "data"
        ]
      },
      "NoResourceBody": {
        "properties": {
          "errors": {
            "type": "array",
            "description": "A list of errors returned with the response, if the request could not be completed. Each object includes details about a specific issue.",
            "items": {
              "$ref": "#/components/schemas/ProblemDetail",
              "description": "A problem detail object is a way to convey information about an error that occurred while processing a request."
            }
          },
          "meta": {
            "additionalProperties": true,
            "description": "Additional contextual information about the response. May include summary data such as item counts, timestamps, or other calculated values."
          },
          "included": {
            "type": "array",
            "description": "A list of related resources included in the response, either automatically by the API or in response to an include parameter in the request. Each item contains a full resource object (e.g., users, teams, acceptance criteria).",
            "items": {}
          },
          "links": {
            "additionalProperties": {
              "type": "string",
              "format": "uri"
            },
            "description": "Pagination or navigation links related to the response. May include keys such as `self`, `next`, `prev`, `first`, or `last`."
          }
        },
        "readOnly": true
      },
      "ProblemDetail": {
        "description": "A problem detail object is a way to convey information about an error that occurred while processing a request.",
        "properties": {
          "id": {
            "type": "string",
            "description": "A unique identifier for this specific error occurrence. Useful for debugging and support."
          },
          "links": {
            "additionalProperties": {
              "type": "string",
              "format": "uri"
            },
            "allOf": [
              {
                "type": [
                  "null",
                  "object"
                ]
              }
            ],
            "description": "Links related to the error. May include a URL to relevant documentation or support resources."
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "description": "The HTTP status code associated with the error (e.g., 400, 404, 422)."
          },
          "code": {
            "type": "string",
            "description": "An internal code that identifies the type or category of the error."
          },
          "title": {
            "type": "string",
            "description": "A short summary of the problem."
          },
          "source": {
            "type": [
              "null",
              "object"
            ],
            "allOf": [
              {
                "$ref": "#/components/schemas/ProblemSource"
              }
            ],
            "readOnly": true
          },
          "detail": {
            "type": "string",
            "description": "Additional information about the error, intended to provide more context than the title."
          },
          "meta": {
            "additionalProperties": true,
            "description": "Additional information about the error, which may be useful for debugging. The contents vary depending on the error type."
          }
        },
        "readOnly": true
      },
      "ProblemSource": {
        "description": "Identifies the part of the request that caused the error. Only one source is present per error.",
        "properties": {
          "pointer": {
            "type": [
              "string",
              "null"
            ],
            "description": "Specifies the path to the field in the request body that caused the error."
          },
          "parameter": {
            "type": [
              "string",
              "null"
            ],
            "description": "Identifies a query parameter in the request URL that caused the error."
          },
          "header": {
            "type": [
              "string",
              "null"
            ],
            "description": "Identifies the request header that caused the error."
          }
        },
        "readOnly": true
      },
      "RelationshipLinks": {
        "properties": {
          "self": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri"
          },
          "related": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri"
          }
        },
        "required": [
          "related",
          "self"
        ]
      },
      "Request_TeamCreateResourceV1_": {
        "properties": {
          "data": {
            "$ref": "#/components/schemas/TeamCreateResourceV1"
          }
        },
        "required": [
          "data"
        ]
      },
      "ResourceIdentifier": {
        "properties": {
          "type": {
            "type": "string",
            "description": "Identifies the type of the linked resource."
          },
          "id": {
            "type": "string",
            "description": "The unique identifier of the linked resource."
          }
        },
        "required": [
          "id",
          "type"
        ]
      },
      "SingleRelationship": {
        "properties": {
          "links": {
            "$ref": "#/components/schemas/RelationshipLinks"
          },
          "data": {
            "$ref": "#/components/schemas/ResourceIdentifier"
          },
          "meta": {
            "additionalProperties": true
          }
        },
        "required": [
          "data",
          "links",
          "meta"
        ]
      },
      "SingleResourceBody_TeamResourceV1_": {
        "properties": {
          "data": {
            "allOf": [
              {
                "$ref": "#/components/schemas/TeamResourceV1"
              }
            ],
            "description": "The returned resource, based on the request."
          },
          "errors": {
            "type": "array",
            "description": "A list of errors returned with the response, if the request could not be completed. Each object includes details about a specific issue.",
            "items": {
              "$ref": "#/components/schemas/ProblemDetail",
              "description": "A problem detail object is a way to convey information about an error that occurred while processing a request."
            }
          },
          "meta": {
            "additionalProperties": true,
            "description": "Additional contextual information about the response. May include summary data such as item counts, timestamps, or other calculated values."
          },
          "included": {
            "type": "array",
            "description": "A list of related resources included in the response, either automatically by the API or in response to an include parameter in the request. Each item contains a full resource object (e.g., users, teams, acceptance criteria).",
            "items": {}
          },
          "links": {
            "additionalProperties": {
              "type": "string",
              "format": "uri"
            },
            "description": "Pagination or navigation links related to the response. May include keys such as `self`, `next`, `prev`, `first`, or `last`."
          }
        },
        "readOnly": true
      },
      "TeamCreateResourceV1": {
        "description": "A team represents a group of people responsible for delivering and supporting work in Atono. Each team has its own backlog, workflow, and membership, and may be linked to a Slack channel for communication.",
        "properties": {
          "type": {
            "type": "string",
            "default": "team",
            "description": "Identifies the type of resource.",
            "minLength": 1,
            "pattern": "team",
            "defaultValue": "team",
            "requiredMode": "REQUIRED"
          },
          "attributes": {
            "allOf": [
              {
                "$ref": "#/components/schemas/TeamCreateResourceV1.Attributes"
              }
            ],
            "description": "Contains the structured data fields that describe the resource, such as properties, settings, and timestamps."
          },
          "relationships": {
            "type": [
              "null",
              "object"
            ],
            "allOf": [
              {
                "$ref": "#/components/schemas/TeamCreateResourceV1.Relationships"
              }
            ],
            "description": "Contains references to other related resources."
          }
        },
        "required": [
          "attributes",
          "type"
        ],
        "writeOnly": true
      },
      "TeamCreateResourceV1.Attributes": {
        "description": "Contains the structured data fields that describe the resource, such as properties, settings, and timestamps.",
        "properties": {
          "name": {
            "type": "string",
            "description": "The name of the team.",
            "maxLength": 200,
            "minLength": 1,
            "requiredMode": "REQUIRED"
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "The description of the team.",
            "maxLength": 2000,
            "requiredMode": "NOT_REQUIRED"
          },
          "isPublic": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicates whether access to the team’s backlog is public (`true`) or private (`false`).",
            "requiredMode": "NOT_REQUIRED"
          },
          "backlogManagementByOwners": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Indicates whether backlog management is enabled for the team (`true`) or not (`false`). When enabled, the team's backlog managers are responsible for managing stories in the 'To do' and 'Won't do' categories of the workflow.",
            "requiredMode": "NOT_REQUIRED"
          },
          "timezone": {
            "type": [
              "string",
              "null"
            ],
            "description": "The IANA timezone identifier for the team (e.g., 'America/New_York', 'Europe/London'). This timezone is used for date calculations and display. If not specified, defaults to 'US/Pacific'.",
            "maxLength": 255,
            "requiredMode": "NOT_REQUIRED"
          }
        },
        "required": [
          "name"
        ]
      },
      "TeamCreateResourceV1.Relationships": {
        "description": "Contains references to other related resources.",
        "properties": {
          "members": {
            "allOf": [
              {
                "$ref": "#/components/schemas/MultipleRelationshipsUpdate"
              }
            ],
            "description": "A relationship object linking to the users added to the team as members. Includes references to the users, along with related links and metadata. This does not include users with team roles such as team admins or backlog owners, unless they are also explicitly added as members of the team."
          }
        },
        "required": [
          "members"
        ]
      },
      "TeamResourceV1": {
        "description": "A team represents a group of people responsible for delivering and supporting work in Atono. Each team has its own backlog, workflow, and membership, and may be linked to a Slack channel for communication.",
        "properties": {
          "type": {
            "type": "string",
            "default": "team",
            "description": "Identifies the type of resource.",
            "pattern": "team",
            "defaultValue": "team"
          },
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "The unique identifier for the resource, typically a UUID."
          },
          "attributes": {
            "allOf": [
              {
                "$ref": "#/components/schemas/TeamResourceV1.Attributes"
              }
            ],
            "description": "Contains the structured data fields that describe the resource, such as properties, settings, and timestamps."
          },
          "relationships": {
            "allOf": [
              {
                "$ref": "#/components/schemas/TeamResourceV1.Relationships"
              }
            ],
            "description": "Contains references to other related resources."
          }
        },
        "readOnly": true
      },
      "TeamResourceV1.Attributes": {
        "description": "Contains the structured data fields that describe the resource, such as properties, settings, and timestamps.",
        "properties": {
          "name": {
            "type": "string",
            "description": "The name of the team."
          },
          "description": {
            "type": "string",
            "description": "The description of the team."
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "description": "The date and time the team was created."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "The date and time the team was last updated."
          },
          "isPublic": {
            "type": "boolean",
            "description": "Indicates whether access to the team’s backlog is public (`true`) or private (`false`)."
          },
          "backlogManagementByOwners": {
            "type": "boolean",
            "description": "Indicates whether backlog management is enabled for the team (`true`) or not (`false`). When enabled, the team's backlog managers are responsible for managing stories in the 'To do' and 'Won't do' categories of the workflow."
          },
          "timezone": {
            "type": "string",
            "description": "The IANA timezone identifier for the team (e.g., 'America/New_York', 'Europe/London'). This timezone is used for date calculations and display. If not specified, defaults to 'US/Pacific'."
          }
        }
      },
      "TeamResourceV1.Relationships": {
        "description": "Contains references to other related resources.",
        "properties": {
          "members": {
            "allOf": [
              {
                "$ref": "#/components/schemas/MultipleRelationships"
              }
            ],
            "description": "A relationship object linking to the users added to the team as members. Includes references to the users, along with related links and metadata. This does not include users with team roles such as team admins or backlog owners, unless they are also explicitly added as members of the team."
          },
          "channel": {
            "type": [
              "null",
              "object"
            ],
            "allOf": [
              {
                "$ref": "#/components/schemas/SingleRelationship"
              }
            ],
            "description": "A relationship object linking to the Slack channel associated with the team. Includes a reference to the channel, along with related links and metadata."
          }
        }
      }
    },
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "name": "X-API-KEY",
        "in": "header"
      }
    }
  }
}
```