---
title: "Request connector run"
method: POST
path: "/v0/connectors/{connector_id}/runs"
tags: ["Connectors"]
---

# Request connector run

`POST /v0/connectors/{connector_id}/runs`

## Request

- Base URL: `https://docs.quivr.thevibecompany.co` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.quivr.thevibecompany.co/v0/connectors/{connector_id}/runs`
- Auth: HTTP bearer

Ask for an acquisition run now instead of at the next scheduled time, for example to check again a source that failed. The next run is pulled in, never pushed out, so repeating the request changes nothing and a run already in flight answers it. Rate limits still hold -- the run starts no sooner than the deployment interval floor (30 s by default) after the previous run ended, nor before the Retry-After the source asked for. The run then goes through the usual scheduler lease and records its outcome in health, committing connector.health_changed when the state changes; the request itself commits no event. run_at is when the run is due; the scheduler starts it within seconds after. A disabled instance is 409 connector_disabled; a paused instance is 409 connector_paused.

## Path parameters

- `connector_id` string, required

## Request body

- ActionRequest
  - `idempotency_key` string, required

## Response `202`

Successful response

- ConnectorRunRequest
  - `connector_id` string, required
  - `run_at` string, date-time, required: When the requested run is due; now unless the interval floor or the source's Retry-After defers it.

## Other responses

- `default`: Structured error; see contract HTTP mapping.

---

[API](https://skmtc.dev/thevibecompany/apis/quivr-http-api.md) - [All operations](https://skmtc.dev/thevibecompany/apis/quivr-http-api/llms.txt) - [OpenAPI document](https://skmtc.dev/thevibecompany/apis/quivr-http-api/revisions/4f4e30ba8f4e?raw)