# HTTP response codes

After sending an HTTP request to a server, the server responds with (among others) a Status Code, which indicates the outcome of the request made to the server.

Within the iSHARE Scheme, the HTTP standard concerning response codes is followed as established by the IETF. Please refer to the [IETF website](https://www.ietf.org/assignments/http-status-codes/http-status-codes.xml) for further specifications. Within iSHARE, the HTTP response codes 401, 403, 406, 409 and 412 are most relevant.

<table data-full-width="false"><thead><tr><th>HTTP Verb</th><th width="166">CRUD</th><th>Entire Collection (e.g. /customers)</th><th>Specific Item (e.g. /customers/{id})</th></tr></thead><tbody><tr><td>POST</td><td>Create</td><td>201 (Created), 'Location' header with link to /customers/{id} containing new ID.</td><td>404 (Not Found), 409 (Conflict) if resource already exists..</td></tr><tr><td>GET</td><td>Read</td><td>200 (OK), list of customers. Use pagination, sorting and filtering to navigate big lists.</td><td>200 (OK), single customer. 404 (Not Found), if ID not found or invalid.</td></tr><tr><td>PUT</td><td>Update/Replace</td><td>404 (Not Found), unless you want to update/replace every resource in the entire collection.</td><td>200 (OK) or 204 (No Content). 404 (Not Found), if ID not found or invalid.</td></tr><tr><td>PATCH</td><td>Update/Modify</td><td>404 (Not Found), unless you want to modify the collection itself.</td><td>200 (OK) or 204 (No Content). 404 (Not Found), if ID not found or invalid.</td></tr><tr><td>DELETE</td><td>Delete</td><td>404 (Not Found), unless you want to delete the whole collection—not often desirable.</td><td>200 (OK). 404 (Not Found), if ID not found or invalid.</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://dev.ishare.eu/introduction/specific-technical-standards/http-response-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.
