> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nedzo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Test a custom action

> Call a custom action's endpoint once and see what it answers.

> [!NOTE]
>
> This endpoint is for the VIP plan only. Other plans get a `403`. See [Plan access](https://docs.nedzo.ai/api-reference/introduction.md#plan-access).

## Path Parameters

**id** `string` *required*

Custom action UUID

## Body

**arguments** `object`

The values the agent would fill in, like `{ "zip": "94107" }`.

We call your endpoint once with the saved URL, headers and auth, the same way a live call would. We wait up to 30 seconds and follow up to 5 redirects. A redirect to a private or internal address is refused. When a redirect goes to another address (a different host, http or https, or port), we do not send your auth there. Your other headers go with it. You can test 10 times a minute per workspace.

```bash cURL theme={null}
curl -X POST "https://api.nedzo.ai/v1/custom-actions/5a3c1e2b-8d7f-4b6a-9c0e-1f2a3b4c5d6e/test" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{ "arguments": { "zip": "94107" } }'
```

```json Response theme={null}
{
  "success": true,
  "message": "Endpoint responded with 200 OK",
  "status": 200,
  "statusText": "OK",
  "body": "{\"covered\":true}",
  "durationMs": 182,
  "error": null
}
```

`body` holds up to 4,000 characters of the answer. When the call fails, `success` is `false` and `error` says why.

## Errors

| Status | When |
| - | - |
| `400` | `id` is not a valid UUID, or the action has no URL to test. |
| `404` | The action is not in your API key's scope. |
| `429` | More than 10 tests in a minute. Wait a minute. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.