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

# Test Integration

> Run the live connection test again and store the result

Run the live test of a connection. For a key provider, this checks the credentials. For a custom MCP server, it checks the server. For a custom webhook, it sends a signed `ping` event to the URL of the first action.

The result is stored on the connection. A failed test is not an HTTP error. It comes back as `ok: false` with a fixed message.

A webhook counts as connected when your endpoint answers any `2xx` status. The body is not read. See [The ping test](https://docs.60db.ai/features/agents-integrations.md#the-ping-test).

## Request

### Headers

**Authorization** `string` *required*

Bearer token with your API key (scope `agents`)

### Path

**id** `string` *required*

The connection `id` (UUID)

## Response

**200 OK**

```json theme={null}
{ "success": true, "data": { "ok": true } }
```

or, when the test failed:

```json theme={null}
{ "success": true, "data": { "ok": false, "error": "The provider rejected the credentials" } }
```

## Errors

| Status | Code | Meaning |
| - | - | - |
| 403 | `POLICY_DENY` | Your role cannot manage integrations, or the API key lacks the `agents` scope |
| 404 | `INTEGRATION_NOT_FOUND` | No connection with this ID in your workspace |
| 422 | `INTEGRATION_PROVIDER_REMOVED` | The provider is no longer offered. Delete the connection |
| 429 | `RATE_LIMITED` | More than 30 checks in the last minute |

## Example

```bash cURL theme={null}
curl -X POST https://api.60db.ai/agents/integrations/INTEGRATION_ID/test \
  -H "Authorization: Bearer your-api-key"
```


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