Coolify Teams API

Teams

OpenAPI Specification

coolify-teams-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: Coolify Applications Teams API
  version: '0.1'
  description: Applications
servers:
- url: https://app.coolify.io/api/v1
  description: Coolify Cloud API. Change the host to your own instance if you are self-hosting.
tags:
- name: Teams
  description: Teams
paths:
  /teams:
    get:
      tags:
      - Teams
      summary: List
      description: Get all teams.
      operationId: list-teams
      responses:
        '200':
          description: List of teams.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Team'
        '401':
          $ref: '#/components/responses/401'
        '400':
          $ref: '#/components/responses/400'
      security:
      - bearerAuth: []
  /teams/{id}:
    get:
      tags:
      - Teams
      summary: Get
      description: Get team by TeamId.
      operationId: get-team-by-id
      parameters:
      - name: id
        in: path
        description: Team ID
        required: true
        schema:
          type: integer
      responses:
        '200':
          description: List of teams.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Team'
        '401':
          $ref: '#/components/responses/401'
        '400':
          $ref: '#/components/responses/400'
        '404':
          $ref: '#/components/responses/404'
      security:
      - bearerAuth: []
  /teams/{id}/members:
    get:
      tags:
      - Teams
      summary: Members
      description: Get members by TeamId.
      operationId: get-members-by-team-id
      parameters:
      - name: id
        in: path
        description: Team ID
        required: true
        schema:
          type: integer
      responses:
        '200':
          description: List of members.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/User'
        '401':
          $ref: '#/components/responses/401'
        '400':
          $ref: '#/components/responses/400'
        '404':
          $ref: '#/components/responses/404'
      security:
      - bearerAuth: []
  /teams/current:
    get:
      tags:
      - Teams
      summary: Authenticated Team
      description: Get currently authenticated team.
      operationId: get-current-team
      responses:
        '200':
          description: Current Team.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Team'
        '401':
          $ref: '#/components/responses/401'
        '400':
          $ref: '#/components/responses/400'
      security:
      - bearerAuth: []
  /teams/current/members:
    get:
      tags:
      - Teams
      summary: Authenticated Team Members
      description: Get currently authenticated team members.
      operationId: get-current-team-members
      responses:
        '200':
          description: Currently authenticated team members.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/User'
        '401':
          $ref: '#/components/responses/401'
        '400':
          $ref: '#/components/responses/400'
      security:
      - bearerAuth: []
components:
  schemas:
    User:
      description: User model
      properties:
        id:
          type: integer
          description: The user identifier in the database.
        name:
          type: string
          description: The user name.
        email:
          type: string
          description: The user email.
        email_verified_at:
          type: string
          description: The date when the user email was verified.
        created_at:
          type: string
          description: The date when the user was created.
        updated_at:
          type: string
          description: The date when the user was updated.
        two_factor_confirmed_at:
          type: string
          description: The date when the user two factor was confirmed.
        force_password_reset:
          type: boolean
          description: The flag to force the user to reset the password.
        marketing_emails:
          type: boolean
          description: The flag to receive marketing emails.
      type: object
    Team:
      description: Team model
      properties:
        id:
          type: integer
          description: The unique identifier of the team.
        name:
          type: string
          description: The name of the team.
        description:
          type: string
          description: The description of the team.
        personal_team:
          type: boolean
          description: Whether the team is personal or not.
        created_at:
          type: string
          description: The date and time the team was created.
        updated_at:
          type: string
          description: The date and time the team was last updated.
        show_boarding:
          type: boolean
          description: Whether to show the boarding screen or not.
        custom_server_limit:
          type: string
          description: The custom server limit.
        members:
          description: The members of the team.
          type: array
          items:
            $ref: '#/components/schemas/User'
      type: object
  responses:
    '400':
      description: Invalid token.
      content:
        application/json:
          schema:
            properties:
              message:
                type: string
                example: Invalid token.
            type: object
    '404':
      description: Resource not found.
      content:
        application/json:
          schema:
            properties:
              message:
                type: string
                example: Resource not found.
            type: object
    '401':
      description: Unauthenticated.
      content:
        application/json:
          schema:
            properties:
              message:
                type: string
                example: Unauthenticated.
            type: object
  securitySchemes:
    bearerAuth:
      type: http
      description: Go to `Keys & Tokens` / `API tokens` and create a new token. Use the token as the bearer token.
      scheme: bearer