> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developer.artlist.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.artlist.io/_mcp/server.

# API Responses

> API Responses

## Status Codes

The table below summarizes the HTTP response codes returned from the Primer REST API.

| Property | Value                   |
| -------- | ----------------------- |
| `200`    | Success                 |
| `400`    | Bad Request             |
| `401`    | Unauthorized            |
| `403`    | Forbidden               |
| `404`    | Entity Not Found        |
| `422`    | Input Validation Failed |
| `429`    | Too Many Requests       |

## Error Responses

Artlist uses standard HTTP response codes to indicate the success or failure of API requests. Codes in the 2XX range indicate a success, while codes in the 4XX range indicate a failure, typically due to invalid inputs or operations.
The error payload format is consistent for all errors. In the event of an unsuccessful, the payload will follow this structure:

```js
{
  "success": false, 
  "error": {
    "message": "Not found",
    "code": 1,
    "status": 404 
  },
}
```