Teams

List Teams

get

List all teams user has access to.

Returns teams where user is a member, along with their role in each team.

Header parameters

authorizationany ofOptional

stringOptional

or

nullOptional

X-Atlas-API-Keyany ofOptional

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

Response model for team.

team_idstringRequired

team_namestringRequired

org_idstringRequired

is_defaultbooleanOptionalDefault: false

descriptionany ofOptional

stringOptional

or

nullOptional

statusstringOptionalDefault: active

user_roleany ofOptional

stringOptional

or

nullOptional

422

Validation Error

application/json

get

/v1/admin/teams

HTTPcURLJavaScriptPython

GET /v1/admin/teams HTTP/1.1
Accept: */*

[
  {
    "team_id": "text",
    "team_name": "text",
    "org_id": "text",
    "is_default": false,
    "description": "text",
    "status": "active",
    "settings": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "metadata": {
      "created_at": "text",
      "created_by": "text",
      "updated_at": "text",
      "updated_by": "text"
    },
    "stats": {
      "member_count": 1,
      "project_count": 1
    },
    "user_role": "text"
  }
]

Create Team

post

Create a new team.

Requires: org_admin or super_admin role

The creator is automatically assigned as team_admin.

Header parameters

authorizationany ofOptional

stringOptional

or

nullOptional

X-Atlas-API-Keyany ofOptional

stringOptional

or

nullOptional

Body

application/json

Request model for creating a team.

team_namestring · min: 1 · max: 100Required

descriptionany ofOptional

string · max: 500Optional

or

nullOptional

settingsany ofOptional

or

nullOptional

Responses

201

Successful Response

application/json

422

Validation Error

application/json

post

/v1/admin/teams

HTTPcURLJavaScriptPython

POST /v1/admin/teams HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 112

{
  "team_name": "text",
  "description": "text",
  "settings": {
    "default_project_id": "text",
    "auto_assign_new_users": false
  }
}

{
  "team_id": "text",
  "team_name": "text",
  "org_id": "text",
  "is_default": false,
  "description": "text",
  "status": "active",
  "settings": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "metadata": {
    "created_at": "text",
    "created_by": "text",
    "updated_at": "text",
    "updated_by": "text"
  },
  "stats": {
    "member_count": 1,
    "project_count": 1
  },
  "user_role": "text"
}

Get Team

get

Get team details.

User must be a member of the team to view details.

Path parameters

team_idstringRequired

Header parameters

authorizationany ofOptional

stringOptional

or

nullOptional

X-Atlas-API-Keyany ofOptional

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

Response model for team.

team_idstringRequired

team_namestringRequired

org_idstringRequired

is_defaultbooleanOptionalDefault: false

descriptionany ofOptional

stringOptional

or

nullOptional

statusstringOptionalDefault: active

user_roleany ofOptional

stringOptional

or

nullOptional

422

Validation Error

application/json

get

/v1/admin/teams/{team_id}

HTTPcURLJavaScriptPython

GET /v1/admin/teams/{team_id} HTTP/1.1
Accept: */*

{
  "team_id": "text",
  "team_name": "text",
  "org_id": "text",
  "is_default": false,
  "description": "text",
  "status": "active",
  "settings": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "metadata": {
    "created_at": "text",
    "created_by": "text",
    "updated_at": "text",
    "updated_by": "text"
  },
  "stats": {
    "member_count": 1,
    "project_count": 1
  },
  "user_role": "text"
}

Delete Team

delete

Delete (soft delete) a team.

Requires: org_admin or super_admin role

Path parameters

team_idstringRequired

Header parameters

authorizationany ofOptional

stringOptional

or

nullOptional

X-Atlas-API-Keyany ofOptional

stringOptional

or

nullOptional

Responses

204

Successful Response

422

Validation Error

application/json

delete

/v1/admin/teams/{team_id}

HTTPcURLJavaScriptPython

DELETE /v1/admin/teams/{team_id} HTTP/1.1
Accept: */*

No content

Update Team

patch

Update team details.

Requires: team_admin role or higher

Path parameters

team_idstringRequired

Header parameters

authorizationany ofOptional

stringOptional

or

nullOptional

X-Atlas-API-Keyany ofOptional

stringOptional

or

nullOptional

Body

application/json

Request model for updating a team.

team_nameany ofOptional

string · min: 1 · max: 100Optional

or

nullOptional

descriptionany ofOptional

string · max: 500Optional

or

nullOptional

settingsany ofOptional

or

nullOptional

Responses

200

Successful Response

application/json

Response model for team.

team_idstringRequired

team_namestringRequired

org_idstringRequired

is_defaultbooleanOptionalDefault: false

descriptionany ofOptional

stringOptional

or

nullOptional

statusstringOptionalDefault: active

user_roleany ofOptional

stringOptional

or

nullOptional

422

Validation Error

application/json

patch

/v1/admin/teams/{team_id}

HTTPcURLJavaScriptPython

PATCH /v1/admin/teams/{team_id} HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 112

{
  "team_name": "text",
  "description": "text",
  "settings": {
    "default_project_id": "text",
    "auto_assign_new_users": false
  }
}

{
  "team_id": "text",
  "team_name": "text",
  "org_id": "text",
  "is_default": false,
  "description": "text",
  "status": "active",
  "settings": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "metadata": {
    "created_at": "text",
    "created_by": "text",
    "updated_at": "text",
    "updated_by": "text"
  },
  "stats": {
    "member_count": 1,
    "project_count": 1
  },
  "user_role": "text"
}

Update Team Status

patch

Activate or deactivate a team.

Requires: org_admin or super_admin role

Args: team_id: Team ID status: New status ('active' or 'inactive')

Path parameters

team_idstringRequired

Query parameters

statusstringRequired

Header parameters

authorizationany ofOptional

stringOptional

or

nullOptional

X-Atlas-API-Keyany ofOptional

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

Response model for team.

team_idstringRequired

team_namestringRequired

org_idstringRequired

is_defaultbooleanOptionalDefault: false

descriptionany ofOptional

stringOptional

or

nullOptional

statusstringOptionalDefault: active

user_roleany ofOptional

stringOptional

or

nullOptional

422

Validation Error

application/json

patch

/v1/admin/teams/{team_id}/status

HTTPcURLJavaScriptPython

PATCH /v1/admin/teams/{team_id}/status?status=text HTTP/1.1
Accept: */*

{
  "team_id": "text",
  "team_name": "text",
  "org_id": "text",
  "is_default": false,
  "description": "text",
  "status": "active",
  "settings": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "metadata": {
    "created_at": "text",
    "created_by": "text",
    "updated_at": "text",
    "updated_by": "text"
  },
  "stats": {
    "member_count": 1,
    "project_count": 1
  },
  "user_role": "text"
}

List Team Members

get

List all members of a team.

User must be a member of the team to view members.

Path parameters

team_idstringRequired

Header parameters

authorizationany ofOptional

stringOptional

or

nullOptional

X-Atlas-API-Keyany ofOptional

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

Response model for team member.

user_idstringRequired

user_emailstringRequired

user_namestringRequired

rolestringRequired

assigned_atstringRequired

assigned_bystringRequired

422

Validation Error

application/json

get

/v1/admin/teams/{team_id}/members

HTTPcURLJavaScriptPython

GET /v1/admin/teams/{team_id}/members HTTP/1.1
Accept: */*

[
  {
    "user_id": "text",
    "user_email": "text",
    "user_name": "text",
    "role": "text",
    "assigned_at": "text",
    "assigned_by": "text"
  }
]

Add Team Member

post

Add a member to a team.

Requires: team_admin role or higher

Path parameters

team_idstringRequired

Header parameters

authorizationany ofOptional

stringOptional

or

nullOptional

X-Atlas-API-Keyany ofOptional

stringOptional

or

nullOptional

Body

application/json

Request to add a member to a team.

user_emailany ofOptional

stringOptional

or

nullOptional

user_idany ofOptional

stringOptional

or

nullOptional

rolestring · enumOptional

Role types in the system.

Default: team_memberPossible values:

Responses

201

Successful Response

application/json

422

Validation Error

application/json

post

/v1/admin/teams/{team_id}/members

HTTPcURLJavaScriptPython

POST /v1/admin/teams/{team_id}/members HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 59

{
  "user_email": "text",
  "user_id": "text",
  "role": "team_member"
}

No content

Bulk Add Team Members

post

Bulk add members to a team.

• Max 100 users per request

• Returns success/failure per user

• Requires: manage:team_users permission

Path parameters

team_idstringRequired

Header parameters

authorizationany ofOptional

stringOptional

or

nullOptional

X-Atlas-API-Keyany ofOptional

stringOptional

or

nullOptional

Body

application/json

Request to bulk add members to a team.

user_idsstring[] · min: 1 · max: 100Required

List of user IDs (max 100)

rolestring · enumOptional

Role to assign to all users

Default: team_memberPossible values:

Responses

201

Successful Response

application/json

422

Validation Error

application/json

post

/v1/admin/teams/{team_id}/members/bulk

HTTPcURLJavaScriptPython

POST /v1/admin/teams/{team_id}/members/bulk HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 42

{
  "user_ids": [
    "text"
  ],
  "role": "team_member"
}

No content

Remove Team Member

delete

Remove a member from a team.

Requires: team_admin role or higher

Path parameters

team_idstringRequired

user_idstringRequired

Header parameters

authorizationany ofOptional

stringOptional

or

nullOptional

X-Atlas-API-Keyany ofOptional

stringOptional

or

nullOptional

Responses

204

Successful Response

422

Validation Error

application/json

delete

/v1/admin/teams/{team_id}/members/{user_id}

HTTPcURLJavaScriptPython

DELETE /v1/admin/teams/{team_id}/members/{user_id} HTTP/1.1
Accept: */*

No content

Get Team Policy

get

Get team policy configuration.

Returns team policy information including allowed services. This is used to show warnings in the UI when team policy is missing.

Path parameters

team_idstringRequired

Header parameters

authorizationany ofOptional

stringOptional

or

nullOptional

X-Atlas-API-Keyany ofOptional

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

Team policy response.

has_policybooleanRequired

policy_idany ofOptional

stringOptional

or

nullOptional

enabledbooleanOptionalDefault: false

allowed_servicesstring[]OptionalDefault: []

rate_limitany ofOptional

integerOptional

or

nullOptional

quota_multiplierany ofOptional

numberOptional

or

nullOptional

descriptionany ofOptional

stringOptional

or

nullOptional

created_atany ofOptional

stringOptional

or

nullOptional

updated_atany ofOptional

stringOptional

or

nullOptional

422

Validation Error

application/json

get

/v1/admin/teams/{team_id}/policy

HTTPcURLJavaScriptPython

GET /v1/admin/teams/{team_id}/policy HTTP/1.1
Accept: */*

{
  "has_policy": true,
  "policy_id": "text",
  "enabled": false,
  "allowed_services": [
    "text"
  ],
  "rate_limit": 1,
  "quota_multiplier": 1,
  "description": "text",
  "created_at": "text",
  "updated_at": "text"
}

Create Team Policy

post

Create team policy.

Requires: team_admin role or higher. Defines which services the team can access via API keys.

Path parameters

team_idstringRequired

Header parameters

authorizationany ofOptional

stringOptional

or

nullOptional

X-Atlas-API-Keyany ofOptional

stringOptional

or

nullOptional

Body

application/json

Request to create team policy.

allowed_servicesstring[]Required

List of allowed service names

rate_limitintegerOptional

Rate limit (requests/min)

Default: 500

quota_multipliernumberOptional

Quota multiplier

Default: 1

descriptionany ofOptional

stringOptional

or

nullOptional

enabledbooleanOptionalDefault: true

Responses

201

Successful Response

application/json

422

Validation Error

application/json

post

/v1/admin/teams/{team_id}/policy

HTTPcURLJavaScriptPython

POST /v1/admin/teams/{team_id}/policy HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 103

{
  "allowed_services": [
    "text"
  ],
  "rate_limit": 500,
  "quota_multiplier": 1,
  "description": "text",
  "enabled": true
}

{
  "has_policy": true,
  "policy_id": "text",
  "enabled": false,
  "allowed_services": [
    "text"
  ],
  "rate_limit": 1,
  "quota_multiplier": 1,
  "description": "text",
  "created_at": "text",
  "updated_at": "text"
}

Delete Team Policy

delete

Delete team policy.

Requires: team_admin role or higher. WARNING: This will prevent all API keys for this team from working!

Path parameters

team_idstringRequired

Header parameters

authorizationany ofOptional

stringOptional

or

nullOptional

X-Atlas-API-Keyany ofOptional

stringOptional

or

nullOptional

Responses

204

Successful Response

422

Validation Error

application/json

delete

/v1/admin/teams/{team_id}/policy

HTTPcURLJavaScriptPython

DELETE /v1/admin/teams/{team_id}/policy HTTP/1.1
Accept: */*

No content

Update Team Policy

patch

Update team policy.

Requires: team_admin role or higher.

Path parameters

team_idstringRequired

Header parameters

authorizationany ofOptional

stringOptional

or

nullOptional

X-Atlas-API-Keyany ofOptional

stringOptional

or

nullOptional

Body

application/json

Request to update team policy.

allowed_servicesany ofOptional

string[]Optional

or

nullOptional

rate_limitany ofOptional

integerOptional

or

nullOptional

quota_multiplierany ofOptional

numberOptional

or

nullOptional

descriptionany ofOptional

stringOptional

or

nullOptional

enabledany ofOptional

booleanOptional

or

nullOptional

Responses

200

Successful Response

application/json

Team policy response.

has_policybooleanRequired

policy_idany ofOptional

stringOptional

or

nullOptional

enabledbooleanOptionalDefault: false

allowed_servicesstring[]OptionalDefault: []

rate_limitany ofOptional

integerOptional

or

nullOptional

quota_multiplierany ofOptional

numberOptional

or

nullOptional

descriptionany ofOptional

stringOptional

or

nullOptional

created_atany ofOptional

stringOptional

or

nullOptional

updated_atany ofOptional

stringOptional

or

nullOptional

422

Validation Error

application/json

patch

/v1/admin/teams/{team_id}/policy

HTTPcURLJavaScriptPython

PATCH /v1/admin/teams/{team_id}/policy HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 101

{
  "allowed_services": [
    "text"
  ],
  "rate_limit": 1,
  "quota_multiplier": 1,
  "description": "text",
  "enabled": true
}

{
  "has_policy": true,
  "policy_id": "text",
  "enabled": false,
  "allowed_services": [
    "text"
  ],
  "rate_limit": 1,
  "quota_multiplier": 1,
  "description": "text",
  "created_at": "text",
  "updated_at": "text"
}

List Available Services

get

List all available services that can be added to team policies.

Returns list of service names from service_routes table.

Header parameters

authorizationany ofOptional

stringOptional

or

nullOptional

X-Atlas-API-Keyany ofOptional

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

string[]Optional

422

Validation Error

application/json

get

/v1/admin/teams/available-services

HTTPcURLJavaScriptPython

GET /v1/admin/teams/available-services HTTP/1.1
Accept: */*

[
  "text"
]