Limits

Use these limits when you request data from the API.

Endpoint	Area	Guarantee	Bounds
GET /api/v1/auth/providers	auth	Authentication provider discovery.	providers: 4 items (MAX_AUTH_PROVIDERS; Caps response).
GET /api/v1/auth/session	auth	Current session and workspace memberships.	memberships: 100 items (MAX_AUTH_SESSION_MEMBERSHIPS; Caps response).
GET /api/v1/account/personal-tokens	auth	Personal access token list.	tokens: 100 items (MAX_PERSONAL_ACCESS_TOKENS_PER_LIST; Caps response).
GET /api/v1/account	auth	Current account profile and preferences.	memberships: 100 items (MAX_ACCOUNT_MEMBERSHIPS; Caps response).
GET /api/v1/projects/:projectId/api-keys	auth	Project API-key list compatibility route.	keys: 100 items (MAX_PROJECT_API_KEYS_PER_LIST; Caps response).
GET /api/v1/workspaces/:workspaceSlug/projects/:projectSlug/api-keys	auth	Project API-key list canonical route.	keys: 100 items (MAX_PROJECT_API_KEYS_PER_LIST; Caps response).
GET /api/v1/workspaces/:workspaceSlug/agents/:agentId/api-keys	auth	Agent API-key list.	keys: 100 items (MAX_PROJECT_API_KEYS_PER_LIST; Caps response).
GET /api/v1/workspaces/:workspaceSlug/members	metadata	Workspace member list.	limit: 100 items (MAX_METADATA_PAGE_SIZE; Rejects over-limit requests).
GET /api/v1/workspaces/:workspaceSlug/projects/:projectSlug/members	metadata	Project member grant list.	limit: 100 items (MAX_METADATA_PAGE_SIZE; Rejects over-limit requests).
GET /api/v1/workspaces/:workspaceSlug/access-summary	metadata	Workspace access and credential summary.	scanLimit: 2,000 items (MAX_WORKSPACE_ACCESS_SUMMARY_SCAN; Clamps and reports). Applied per metadata source in the bounded workspace summary scan.
GET /api/v1/workspaces/:workspaceSlug/invitations	metadata	Workspace invitation list.	limit: 100 items (MAX_METADATA_PAGE_SIZE; Rejects over-limit requests).
GET /api/v1/workspaces/:workspaceSlug/projects/:projectSlug/invitations	metadata	Project-scoped invitation list.	limit: 100 items (MAX_METADATA_PAGE_SIZE; Rejects over-limit requests).
POST /api/v1/artifacts/list	artifacts	Run artifact list.	limit: 100 items (MAX_ARTIFACT_LIST_LIMIT; Rejects over-limit requests).
POST /api/v1/artifacts/lineage	artifacts	Run artifact lineage.	produced/consumed: 100 items (MAX_ARTIFACT_LIST_LIMIT; Rejects over-limit requests). consumers per produced artifact: 100 items (MAX_ARTIFACT_LINEAGE_EDGES; Caps response).
POST /api/v1/artifacts/project/list	artifacts	Project artifact list.	limit: 100 items (MAX_ARTIFACT_LIST_LIMIT; Rejects over-limit requests).
POST /api/v1/query/series	metrics	Bounded metric series query.	metricKeys: 8 series (MAX_SERIES_PER_REQUEST; Rejects over-limit requests). maxPointsPerSeries: 2,000 points (MAX_SERIES_POINTS_PER_METRIC; Rejects over-limit requests). window range: 604,800,000 milliseconds (MAX_SERIES_RANGE_MS; Rejects over-limit requests).
GET /api/v1/metrics/keys	metrics	Metric-key discovery.	limit: 500 items (MAX_METRIC_KEY_DISCOVERY_LIMIT; Rejects over-limit requests).
POST /api/v1/query/logs	logs	Bounded log row query.	limit: 1,000 rows (MAX_QUERY_LOGS_LIMIT; Clamps and reports). Responses report requestedLimit and limitClamped.
POST /api/v1/query/media	media	Bounded media manifest query.	limit: 256 items (MAX_MEDIA_ITEMS_PER_RESPONSE; Rejects over-limit requests). mediaKeys: 32 items (MAX_MEDIA_KEYS_PER_QUERY; Rejects over-limit requests).
POST /api/v1/query/traces	traces	Bounded trace list query.	limit: 100 items (MAX_TRACE_LIST_LIMIT; Rejects over-limit requests). window range: 604,800,000 milliseconds (MAX_TRACE_QUERY_RANGE_MS; Rejects over-limit requests).
POST /api/v1/query/traces/tree	traces	Bounded trace tree page query.	limit: 2,000 rows (MAX_TRACE_TREE_SPANS_PER_RESPONSE; Rejects over-limit requests). Large traces are returned through explicit cursor pages and never as one full tree. attrsJson: 16,384 bytes (MAX_TRACE_ATTRS_JSON_BYTES; Caps response). Inline span attributes are capped at 16 KiB; larger evidence belongs in object storage.
POST /api/v1/query/traces/span	traces	Single trace span detail query.	spans: 1 rows (single-span contract; Caps response). attrsJson: 16,384 bytes (MAX_TRACE_ATTRS_JSON_BYTES; Caps response).
POST /api/v1/query/evals/suites	evals	Bounded eval suite metadata listing.	limit: 100 items (MAX_EVAL_METADATA_LIST_LIMIT; Rejects over-limit requests).
POST /api/v1/query/evals/suite-versions	evals	Bounded eval suite version metadata listing.	limit: 100 items (MAX_EVAL_METADATA_LIST_LIMIT; Rejects over-limit requests).
POST /api/v1/query/evals/targets	evals	Bounded eval target metadata listing.	limit: 100 items (MAX_EVAL_METADATA_LIST_LIMIT; Rejects over-limit requests).
POST /api/v1/query/evals/runs	evals	Bounded eval run metadata listing.	limit: 100 items (MAX_EVAL_METADATA_LIST_LIMIT; Rejects over-limit requests).
POST /api/v1/query/evals/scorecard	evals	Bounded eval scorecard query.	scorers: 64 items (MAX_EVAL_SCORECARD_SCORERS; Caps response). histogram buckets: 20 items (MAX_EVAL_SCORE_HISTOGRAM_BUCKETS; Caps response). score summaries: 64 items (MAX_EVAL_SCORE_SUMMARIES; Caps response).
POST /api/v1/query/evals/drilldown	evals	Bounded eval per-example drilldown query.	limit: 200 rows (MAX_EVAL_DRILLDOWN_LIMIT; Rejects over-limit requests).
POST /api/v1/query/evals/diff	evals	Bounded eval run-over-run diff query.	limit: 200 rows (MAX_EVAL_DIFF_LIMIT; Rejects over-limit requests).
GET /api/v1/workspaces/:workspaceSlug/projects/:projectSlug/evals/overview	evals	Bounded project eval overview.	limit: 100 items (MAX_EVAL_METADATA_LIST_LIMIT; Caps response).
POST /api/v1/workspaces/:workspaceSlug/projects/:projectSlug/evals/suites	evals	Project eval suite creation.	scorers: 32 items (MAX_EVAL_SCORERS; Rejects over-limit requests). policy JSON: 16,384 bytes (MAX_EVAL_SUITE_POLICY_JSON_BYTES; Rejects over-limit requests).
GET /api/v1/workspaces/:workspaceSlug/projects/:projectSlug/evals/suites	evals	Bounded project eval suite list.	limit: 100 items (MAX_EVAL_METADATA_LIST_LIMIT; Rejects over-limit requests).
POST /api/v1/workspaces/:workspaceSlug/projects/:projectSlug/evals/suites/:suiteId/versions	evals	Project eval suite version creation.	scorers: 32 items (MAX_EVAL_SCORERS; Rejects over-limit requests). policy JSON: 16,384 bytes (MAX_EVAL_SUITE_POLICY_JSON_BYTES; Rejects over-limit requests).
GET /api/v1/workspaces/:workspaceSlug/projects/:projectSlug/evals/suites/:suiteId/versions	evals	Bounded project eval suite version list.	limit: 100 items (MAX_EVAL_METADATA_LIST_LIMIT; Rejects over-limit requests).
GET /api/v1/workspaces/:workspaceSlug/projects/:projectSlug/evals/suites/:suiteId	evals	Bounded project eval suite detail.	suite versions: 100 items (MAX_EVAL_METADATA_LIST_LIMIT; Caps response).
POST /api/v1/workspaces/:workspaceSlug/projects/:projectSlug/evals/targets	evals	Project eval target creation.	target spec JSON: 16,384 bytes (MAX_EVAL_TARGET_SPEC_JSON_BYTES; Rejects over-limit requests).
GET /api/v1/workspaces/:workspaceSlug/projects/:projectSlug/evals/targets	evals	Bounded project eval target list.	limit: 100 items (MAX_EVAL_METADATA_LIST_LIMIT; Rejects over-limit requests).
GET /api/v1/workspaces/:workspaceSlug/projects/:projectSlug/evals/targets/:targetId	evals	Single project eval target detail.	targets: 1 items (single-target contract; Caps response).
GET /api/v1/workspaces/:workspaceSlug/projects/:projectSlug/evals/runs	evals	Bounded project eval run list.	limit: 100 items (MAX_EVAL_METADATA_LIST_LIMIT; Rejects over-limit requests).
GET /api/v1/workspaces/:workspaceSlug/projects/:projectSlug/evals/runs/:evalRunId/scorecard	evals	Bounded project eval scorecard.	scorers: 64 items (MAX_EVAL_SCORECARD_SCORERS; Caps response). histogram buckets: 20 items (MAX_EVAL_SCORE_HISTOGRAM_BUCKETS; Caps response). score summaries: 64 items (MAX_EVAL_SCORE_SUMMARIES; Caps response).
GET /api/v1/workspaces/:workspaceSlug/projects/:projectSlug/evals/runs/:evalRunId/results	evals	Bounded project eval result rows.	limit: 200 rows (MAX_EVAL_DRILLDOWN_LIMIT; Rejects over-limit requests).
POST /api/v1/workspaces/:workspaceSlug/projects/:projectSlug/evals/compare	evals	Bounded project eval comparison.	limit: 200 rows (MAX_EVAL_DIFF_LIMIT; Rejects over-limit requests).
POST /api/v1/workspaces/:workspaceSlug/projects/:projectSlug/evals/gates	evals	Project eval gate policy creation.	policy JSON: 16,384 bytes (MAX_EVAL_SUITE_POLICY_JSON_BYTES; Rejects over-limit requests).
GET /api/v1/workspaces/:workspaceSlug/projects/:projectSlug/evals/gates	evals	Bounded project eval gate list.	limit: 100 items (MAX_EVAL_METADATA_LIST_LIMIT; Rejects over-limit requests).
GET /api/v1/workspaces/:workspaceSlug/projects/:projectSlug/evals/runs/:evalRunId/gate	evals	Single project eval gate summary.	gate summaries: 1 items (single-gate contract; Caps response).
GET /api/v1/workspaces/:workspaceSlug/projects/:projectSlug/evals/runs/:evalRunId/results/:exampleId/evidence	evals	Bounded per-example eval evidence expansion.	result rows: 32 rows (MAX_EVAL_EVIDENCE_ROWS; Caps response). traces: 8 items (MAX_EVAL_EVIDENCE_TRACES; Caps response). trace spans: 128 rows (MAX_EVAL_EVIDENCE_TRACE_SPANS; Caps response).
POST /api/v1/query/compare	compare	Bounded multi-run metric comparison.	runIds: 12 runs (MAX_RUNS_PER_COMPARE; Rejects over-limit requests). metricKeys: 8 series (MAX_SERIES_PER_REQUEST; Rejects over-limit requests). maxPointsPerSeries: 2,000 points (MAX_SERIES_POINTS_PER_METRIC; Rejects over-limit requests).
POST /api/v1/export/metrics	export	Paged metrics export.	limit: 5,000 rows (MAX_EXPORT_PAGE_SIZE; Rejects over-limit requests).
POST /api/v1/export/logs	export	Paged logs export.	limit: 5,000 rows (MAX_EXPORT_PAGE_SIZE; Rejects over-limit requests).
GET /api/v1/workspaces	metadata	Accessible workspace list.	limit: 100 items (MAX_METADATA_PAGE_SIZE; Rejects over-limit requests).
GET /api/v1/workspaces/:workspaceSlug/projects	metadata	Workspace project list.	limit: 100 items (MAX_METADATA_PAGE_SIZE; Rejects over-limit requests).
GET /api/v1/workspaces/:workspaceSlug/projects/:projectSlug/runs	metadata	Project run list.	limit: 100 items (MAX_METADATA_PAGE_SIZE; Rejects over-limit requests).
GET /api/v1/workspaces/:workspaceSlug/projects/:projectSlug/runs/query	metadata	Project run search/filter query.	limit: 200 items (MAX_RUN_QUERY_SEARCH_LIMIT; Rejects over-limit requests).
GET /api/v1/workspaces/:workspaceSlug/projects/:projectSlug/models	metadata	Checkpoint-backed model version list.	limit: 100 items (MAX_MODEL_VERSION_LIST_LIMIT; Rejects over-limit requests).
GET /api/v1/workspaces/:workspaceSlug/projects/:projectSlug/models/:modelVersionId/evals	evals	Model eval history list.	limit: 100 items (MAX_MODEL_VERSION_LIST_LIMIT; Rejects over-limit requests).
GET /api/v1/workspaces/:workspaceSlug/audit	metadata	Workspace audit event list.	limit: 100 events (MAX_AUDIT_EVENT_LIST_LIMIT; Rejects over-limit requests).
GET /api/v1/workspaces/:workspaceSlug/webhooks	webhooks	Workspace webhook config list.	limit: 50 items (MAX_WEBHOOK_LIST_LIMIT; Rejects over-limit requests).
GET /api/v1/workspaces/:workspaceSlug/webhook-deliveries	webhooks	Workspace webhook delivery event list.	limit: 100 events (MAX_WEBHOOK_DELIVERY_LIST_LIMIT; Rejects over-limit requests).
GET /api/v1/stream	stream	Signal-only SSE stream.	payload rows: 0 rows (signal-only transport invariant; Signal only). SSE emits generation signals only; data rows are fetched through bounded queries.