> For the complete documentation index, see [llms.txt](/llms.txt).
> A full single-fetch corpus is available at [llms-full.txt](/llms-full.txt).
---
title: "Create a scorer"
description: "Create a scorer record for a custom scorer your worker deploys, so experiments can attach it by ID."
method: "POST"
endpoint: "/api/v1/projects/:projectId/scorers"
order: 3
last_verified: 2026-10-08
---



`POST /api/v1/projects/:projectId/scorers`

Create a scorer record for a custom scorer your worker deploys, so experiments can attach it by ID.


  ## Parameters

  - `projectId` _string_ **required** — The project UUID.
  - `name` _string_ **required** — The scorer name.
  - `type` _string_ **required** — `deployed` for a custom scorer registered by your worker. Also `code`, `llm_judge`, or `builtin`.
  - `deployment_id` _string_ — For `deployed`: the deployment that registers the scorer.
  - `component_name` _string_ — For `deployed`: the registered scorer name, as in `@scorer(name=...)`.
  - `description` _string_ — A description shown with the scorer.



> Pass the returned `id` to `agnt5 experiments create --scorer-id <id>`. See [Custom scorers](/docs/improve/scorers.md#custom-scorers).



  ## Request example


```bash
curl -X POST "https://api.agnt5.com/api/v1/projects/{project_id}/scorers" \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: {api_key}" \
  -d '{"name": "cites_order_id", "type": "deployed", "deployment_id": "{deployment_id}", "component_name": "cites_order_id"}'
```

```javascript
fetch('https://api.agnt5.com/api/v1/projects/' + projectId + '/scorers', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-API-KEY': apiKey },
  body: JSON.stringify({ name: 'cites_order_id', type: 'deployed', deployment_id: deploymentId, component_name: 'cites_order_id' })
})
```


  ```json {{ title: 'Response (201 Created)' }}
  {
    "success": true,
    "data": {
      "id": "57f86534-...",
      "name": "cites_order_id",
      "type": "deployed",
      "enabled": true,
      "deployment_id": "8a1c2d3e-...",
      "component_name": "cites_order_id",
      "version": 1
    }
  }
  ```