Skip to main content

Content Type

All requests with a body must use JSON encoding:
Content-Type: application/json

Request Structure

POST/PUT/PATCH Requests

Send parameters as a JSON object in the request body:
curl -X POST https://api.rubric.ai/v1/datasets \
  -H "Authorization: Bearer gr_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-dataset",
    "description": "Test dataset"
  }'

GET Requests

Pass parameters as query strings:
curl "https://api.rubric.ai/v1/datasets?limit=20&project=proj_abc" \
  -H "Authorization: Bearer gr_live_xxx"

Common Parameters

ParameterTypeDescription
limitintegerMax results to return (default: 20, max: 100)
afterstringCursor for pagination
projectstringFilter by project ID

Request IDs

Every request receives a unique ID in the response headers:
X-Request-ID: req_abc123xyz
Include this ID when contacting support about specific requests.