# Status Codes

The API can return various HTTP status codes indicating the result of the authentication request. Below is a detailed explanation of each status code you might encounter when using the authentication endpoint:

<table><thead><tr><th width="217">Status Code</th><th width="196">Description</th><th>Explanation</th></tr></thead><tbody><tr><td><code>200 OK</code></td><td>Success</td><td>The request was successful, and the user has been authenticated. The response will contain the <code>idToken</code>, <code>accessToken</code>, and <code>refreshToken</code>.</td></tr><tr><td><code>400 Bad Request</code></td><td>Invalid Request</td><td>The request could not be understood by the server due to malformed syntax. This may occur if required fields are missing or improperly formatted.</td></tr><tr><td><code>401 Unauthorized</code></td><td>Invalid Credentials</td><td>The authentication failed because the username or password is incorrect. This status code indicates that the user is not authorized to access the resource.</td></tr><tr><td><code>403 Forbidden</code></td><td>Access Denied</td><td>The server understood the request, but the user does not have permission to access the requested resource. This may occur if the user is not allowed to authenticate or access certain features.</td></tr><tr><td><code>404 Not Found</code></td><td>Endpoint Not Found</td><td>The requested resource could not be found. This typically means that the endpoint URL is incorrect.</td></tr><tr><td><code>500 Internal Server Error</code></td><td>Server Error</td><td>The server encountered an unexpected condition that prevented it from fulfilling the request. This indicates an issue on the server side, not with the request itself.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.senmo.io/foundry-platform/status-codes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
