API v.1

Teams API Errors

Description of possible errors when working with the Teams API and ways to resolve them.

HTTP Status Codes

200 OK - Request completed successfully

201 Created - Resource successfully created

204 No Content - Request completed successfully, but response is empty

400 Bad Request - Invalid request

401 Unauthorized - Not authorized

403 Forbidden - Access denied

404 Not Found - Resource not found

409 Conflict - Data conflict

500 Internal Server Error - Internal server error

Common Error Scenarios
401 Unauthorized

Cause: Missing or invalid JWT token

Solution: Make sure the authorization token is passed in the Authorization header: Bearer {token}


403 Forbidden

Cause: Insufficient rights to perform the operation

Solution: Check that the user has the necessary rights in the team/organization


404 Not Found

Cause: Team not found

Solution: Check the correctness of the team ID


409 Conflict

Cause: User is already a member of the team

Solution: Check if the user is already added to the team

Error Response Format

{
  "error": "Error message",
  "statusCode": 400,
  "details": "Additional error details"
}
Troubleshooting Tips

Make sure the JWT token is valid and not expired

Check the correctness of the team and organization ID

Make sure the user has access to the organization

Check the JSON format in the request

Make sure all required fields are filled

Check that the team name is unique within the organization

An error has occurred. This application may no longer respond until reloaded. Reload 🗙