Request connector access
Record a customer's request for an app we can't connect one-click yet (a bring-your-own-OAuth connector greyed out in the catalogue because it needs Vertical AI's OWN registered OAuth app; connect_workspace_app / initiate_agent_connection return needsSecret / connectableViaMcp:false for these). This does NOT connect the app and collects NO credentials; it files the request to the team (Linear + Slack) so the OAuth app gets registered, after which the connector becomes one-click. Pass the workspace slug and the toolkit slug (from list_available_connectors). Returns { captured: { linear, slack } }; either destination may be unconfigured and the request still succeeds.
Authorization
bearerAuth A personal access token from Settings > API tokens.
In: header
Header Parameters
A key you choose, such as a UUID, that makes this POST safe to retry. Within 24 hours the same key and request answers with the first successful answer and runs nothing, the same key with a different request answers 422 idempotency_key_reused, and a key whose request is still running answers 409 idempotency_key_in_use. A failed request keeps nothing, so the same key runs it again.
1 <= length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/operations/request_connector_access" \ -H "Content-Type: application/json" \ -d '{ "workspace": "string", "toolkit": "string" }'{}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}Reorder tools POST
Reorder all tools. Pass the FULL list in the desired order via toolNames (the tools' snake_case names) or toolIds, every existing tool must be present exactly once; missing or extra entries are rejected. The display order in the editor matches this array; the runtime is order-insensitive (it uses `requires` for sequencing).
Re-score batch POST
Re-score EVERY run in a finished batch with the current metric judge, the batch-scoped twin of rescore_run. Use after editing a metric's judge prompt to re-grade a whole batch against the new judge without re-running the agent. Bounded concurrency keeps it from flooding the judge; per-run failures are reported but don't abort the rest. A batch re-score is N judge passes, so the credit gate runs before the fan-out. Returns the per-run re-scored / failed counts.