Collective Teams

List teams of a collective

get

https://api.example.comhttps://staging-api.example.com

/memberships/collectives/{collectiveId}/teams

Gets the list of all teams that belong to the specified collective

Path parameters

collectiveIdstring · uuidRequired

Unique ID of the collective

Example: collective123-def6-7890-abcd-ef1234567890

Query parameters

pageinteger · min: 1Optional

Page number for pagination

Default: 1Example: 1

limitinteger · min: 1 · max: 100Optional

Number of items per page

Default: 20Example: 20

Responses

200

List of collective teams retrieved successfully

application/json

500

Internal server error

application/json

get

/memberships/collectives/{collectiveId}/teams

HTTPcURLJavaScriptPython

GET /memberships/collectives/{collectiveId}/teams HTTP/1.1
Host: api.example.com
Accept: */*

{
  "data": [
    {
      "id": "team456-abc1-2345-6789-abcdef123456",
      "name": "Riders Team",
      "description": "Delivery riders coordination team",
      "collectiveId": "collective123-def6-7890-abcd-ef1234567890",
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-20T14:45:00Z",
      "memberCount": 8,
      "metadata": {
        "region": "LATAM",
        "vehicleType": "motorcycle"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "totalPages": 1,
    "hasNext": false,
    "hasPrev": false
  }
}

Create a new team in collective

post

https://api.example.comhttps://staging-api.example.com

/memberships/collectives/{collectiveId}/teams

Creates a new team within the specified collective

Path parameters

collectiveIdstring · uuidRequired

Unique ID of the collective

Example: collective123-def6-7890-abcd-ef1234567890

Body

application/json

namestring · max: 100Required

Name of the team

Example: Engineering Team

descriptionstring · max: 500Optional

Description of the team

Example: Core development team

Responses

201

Collective team created successfully

application/json

500

Internal server error

application/json

post

/memberships/collectives/{collectiveId}/teams

HTTPcURLJavaScriptPython

POST /memberships/collectives/{collectiveId}/teams HTTP/1.1
Host: api.example.com
Content-Type: application/json
Accept: */*
Content-Length: 129

{
  "name": "Riders Team",
  "description": "Delivery riders coordination team",
  "metadata": {
    "region": "LATAM",
    "vehicleType": "motorcycle"
  }
}

{
  "id": "team456-abc1-2345-6789-abcdef123456",
  "name": "Riders Team",
  "description": "Delivery riders coordination team",
  "collectiveId": "collective123-def6-7890-abcd-ef1234567890",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:30:00Z",
  "memberCount": 0,
  "metadata": {
    "region": "LATAM",
    "vehicleType": "motorcycle"
  }
}

Get collective team information

get

https://api.example.comhttps://staging-api.example.com

/memberships/collectives/{collectiveId}/teams/{teamId}

Gets the information of a specific team in the collective

Path parameters

collectiveIdstring · uuidRequired

Unique ID of the collective

Example: collective123-def6-7890-abcd-ef1234567890

teamIdstring · uuidRequired

Unique ID of the team

Example: team456-abc1-2345-6789-abcdef123456

Responses

200

Collective team information retrieved successfully

application/json

idstring · uuidOptional

Unique team ID

Example: team123-def6-7890-abcd-ef1234567890

namestringOptional

Name of the team

Example: Engineering Team

descriptionstringOptional

Description of the team

Example: Core development team

organisationIdstring · uuidOptional

ID of the organization this team belongs to (if team belongs to organization)

Example: 123e4567-e89b-12d3-a456-426614174000

collectiveIdstring · uuidOptional

ID of the collective this team belongs to (if team belongs to collective)

Example: collective123-def6-7890-abcd-ef1234567890

memberCountintegerOptional

Number of members in the team

Example: 5

createdAtstring · date-timeOptional

Date and time when the team was created

Example: 2024-01-15T10:30:00Z

updatedAtstring · date-timeOptional

Date and time of last update

Example: 2024-01-20T14:45:00Z

500

Internal server error

application/json

get

/memberships/collectives/{collectiveId}/teams/{teamId}

HTTPcURLJavaScriptPython

GET /memberships/collectives/{collectiveId}/teams/{teamId} HTTP/1.1
Host: api.example.com
Accept: */*

{
  "id": "team456-abc1-2345-6789-abcdef123456",
  "name": "Riders Team",
  "description": "Delivery riders coordination team",
  "collectiveId": "collective123-def6-7890-abcd-ef1234567890",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-20T14:45:00Z",
  "memberCount": 8,
  "metadata": {
    "region": "LATAM",
    "vehicleType": "motorcycle"
  }
}

Update collective team information

put

https://api.example.comhttps://staging-api.example.com

/memberships/collectives/{collectiveId}/teams/{teamId}

Updates the information of a specific team in the collective

Path parameters

collectiveIdstring · uuidRequired

Unique ID of the collective

Example: collective123-def6-7890-abcd-ef1234567890

teamIdstring · uuidRequired

Unique ID of the team

Example: team456-abc1-2345-6789-abcdef123456

Body

application/json

namestring · max: 100Optional

New name for the team

Example: Senior Engineering Team

descriptionstring · max: 500Optional

New description for the team

Example: Senior development team with expanded responsibilities

Responses

200

Collective team updated successfully

application/json

idstring · uuidOptional

Unique team ID

Example: team123-def6-7890-abcd-ef1234567890

namestringOptional

Name of the team

Example: Engineering Team

descriptionstringOptional

Description of the team

Example: Core development team

organisationIdstring · uuidOptional

ID of the organization this team belongs to (if team belongs to organization)

Example: 123e4567-e89b-12d3-a456-426614174000

collectiveIdstring · uuidOptional

ID of the collective this team belongs to (if team belongs to collective)

Example: collective123-def6-7890-abcd-ef1234567890

memberCountintegerOptional

Number of members in the team

Example: 5

createdAtstring · date-timeOptional

Date and time when the team was created

Example: 2024-01-15T10:30:00Z

updatedAtstring · date-timeOptional

Date and time of last update

Example: 2024-01-20T14:45:00Z

500

Internal server error

application/json

put

/memberships/collectives/{collectiveId}/teams/{teamId}

HTTPcURLJavaScriptPython

PUT /memberships/collectives/{collectiveId}/teams/{teamId} HTTP/1.1
Host: api.example.com
Content-Type: application/json
Accept: */*
Content-Length: 190

{
  "name": "Senior Riders Team",
  "description": "Advanced delivery riders coordination team with expanded coverage",
  "metadata": {
    "region": "LATAM",
    "vehicleType": "motorcycle",
    "coverage": "extended"
  }
}

{
  "id": "team456-abc1-2345-6789-abcdef123456",
  "name": "Senior Riders Team",
  "description": "Advanced delivery riders coordination team with expanded coverage",
  "collectiveId": "collective123-def6-7890-abcd-ef1234567890",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-22T16:30:00Z",
  "memberCount": 8,
  "metadata": {
    "region": "LATAM",
    "vehicleType": "motorcycle",
    "coverage": "extended"
  }
}

Delete a collective team

delete

https://api.example.comhttps://staging-api.example.com

/memberships/collectives/{collectiveId}/teams/{teamId}

Deletes a specific team from the collective

Path parameters

collectiveIdstring · uuidRequired

Unique ID of the collective

Example: collective123-def6-7890-abcd-ef1234567890

teamIdstring · uuidRequired

Unique ID of the team to delete

Example: team456-abc1-2345-6789-abcdef123456

Responses

200

Collective team deleted successfully

application/json

successbooleanRequired

Indicates if the operation was successful

Example: true

messagestringRequired

Descriptive success message

Example: Operation completed successfully

500

Internal server error

application/json

delete

/memberships/collectives/{collectiveId}/teams/{teamId}

HTTPcURLJavaScriptPython

DELETE /memberships/collectives/{collectiveId}/teams/{teamId} HTTP/1.1
Host: api.example.com
Accept: */*

{
  "success": true,
  "message": "Team successfully deleted from collective"
}