> For the complete documentation index, see [llms.txt](https://docs.silk.us/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.silk.us/api-reference/using-the-api/errors.md).

# Errors

HTTP status codes returned by the API.

Most error handling is done through HTTP responses. Successful responses use 200-family status codes; errors use 400- and 500-family codes. Along with the status code, the server returns a readable message.

| Status                      | Description                                                                                                  |
| --------------------------- | ------------------------------------------------------------------------------------------------------------ |
| `400 Bad request`           | The client tried to perform an action that cannot be done.                                                   |
| `401 Unauthorized`          | The client tried to access a resource without providing authentication information.                          |
| `403 Forbidden`             | The client does not have permission to execute the requested action.                                         |
| `404 Not found`             | The client requested a resource that does not exist.                                                         |
| `405 Method not allowed`    | The client tried an action the resource doesn't support (for example, `DELETE` on a system capacity policy). |
| `500 Internal server error` | General error returned when the server fails to complete an operation.                                       |
| `502 Bad gateway`           | The Silk REST service was unavailable while performing the request. Recheck the state of the object.         |
| `503 Service unavailable`   | The Silk REST service is busy and cannot execute the operation. Try again later.                             |

## Example

```http
DELETE /api/v2/hosts/2
```

```json
404 Not found

{
  "message": "host with id 2 does not exist"
}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.silk.us/api-reference/using-the-api/errors.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
