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