POST /v1/production-access-requests

Availability	Private Preview
Method and path	`POST /v1/production-access-requests`
API version	`1.0.0-private-preview`
Base URL	`https://api.torq.finance`
Authentication	SecretKey
Idempotency	Required header: Idempotency-Key.
Rate limits	Read `x-ratelimit-*` and `x-request-id` response headers. Do not hard-code a quota.

Authentication requirements

SecretKey

Request examples

terminal

curl -X POST 'https://api.torq.finance/v1/production-access-requests' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer $TORQ_SECRET_KEY' \
  -H 'Idempotency-Key: $TORQ_IDEMPOTENCY_KEY' \
  -H 'Content-Type: application/json' \
  --data '{"scopes":["sample_scopes"],"useCase":"sample_usecase"}'

Run a safe sample

This calls the docs preview and returns sample data shaped by the governed OpenAPI response. It never accepts credentials or changes protocol state.

Run the sample call to inspect a schema-shaped response without credentials or side effects.

Request body	ProductionAccessRequest

Parameters

Name	In	Required	Type
`Idempotency-Key`	header	Yes	`string`

Request schema

ProductionAccessRequest ProductionAccessRequest

Property	Type	Required	Description
`scopes`	`string[]`	Yes	—
`useCase`	`string`	Yes	—

Inspect nested properties

scopes string[] · required

items string

useCase string · required

minimum length: 20 · maximum length: 4000

Responses

Status	Meaning	Schema
`200`	Successful response	`ProductionAccessRequestStatus`
`400`	Invalid request	`TorqApiError`
`401`	Authentication required	`TorqApiError`
`403`	Insufficient scope or authority	`TorqApiError`
`409`	State or idempotency conflict	`TorqApiError`
`429`	Rate limit exceeded	`TorqApiError`
`500`	Internal failure	`TorqApiError`

200 response schema

ProductionAccessRequestStatus ProductionAccessRequestStatus

Property	Type	Required	Description
`id`	`string`	Yes	—
`applicationId`	`string`	Yes	—
`status`	`string`	Yes	—
`scopes`	`string[]`	Yes	—
`requestedAt`	`string (date-time)`	Yes	—

Inspect nested properties

id string · required

minimum length: 1 · maximum length: 200

applicationId string · required

minimum length: 1 · maximum length: 200

status string · required

scopes string[] · required

items string

requestedAt string (date-time) · required

400, 401, 403, 409, 429, 500 response schema

TorqApiError TorqApiError

Property	Type	Required	Description
`ok`	`boolean`	Yes	—
`code`	`string`	Yes	—
`message`	`string`	Yes	—
`requestId`	`string`	Yes	—
`retryable`	`boolean`	Yes	—
`blockedReason`	`string \| null`	No	—
`docsUrl`	`string (uri)`	No	—

Inspect nested properties

ok boolean · required

code string · required

minimum length: 1 · maximum length: 200

message string · required

minimum length: 1 · maximum length: 200

requestId string · required

minimum length: 1 · maximum length: 200

retryable boolean · required

blockedReason string | null · optional

nullable

docsUrl string (uri) · optional

Related guides

For retry behavior and blocked-state handling, see Errors and rate limits.