Skip to main content
GET
/
v1
/
teams
cURL
curl --request GET \
  --url http://sandbox.mintlify.com/v1/teams \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": [
    {
      "id": 1,
      "name": "Acme Corporation",
      "username": "acme-corp",
      "about": "Leading provider of innovative solutions",
      "logo": "https://example.com/logos/acme.png"
    }
  ]
}
Retrieve all teams that the authenticated user is a member of.
Users can only be members of one team. If you already have a team, you cannot create another one.

​
Response

​
success
boolean
required
Indicates whether the request was successful. Always true for successful responses.
​
data
array
Array of team objects.

​
Example Response

{
  "success": true,
  "data": [
    {
      "id": 1,
      "name": "Acme Corporation",
      "username": "acme-corp",
      "about": "Leading provider of innovative solutions",
      "logo": "https://example.com/logos/acme.png"
    }
  ]
}

​
Error Response

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "The given data was invalid."
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

Teams response

​
success
boolean
required

Indicates whether the request was successful

Example:

true

​
data
object
required

The response data. Can be an object, array, or null