Skip to content
Scope
Search
Ctrl
K
Cancel
Select theme
Dark
Light
Auto
Introduction
What is Scope?
Concepts
Getting Started
Access
Install the CLI
Your first run
Guides
Submitting requests (Portal)
Submitting requests (REST API)
Submitting requests (CLI)
Managing task prompts
Defining evaluation criteria
Defining profiles
Working with prompt features
Choosing a coding agent
Choosing software stacks
Prioritizing & pausing requests
Importing MCP servers
Importing skills
Importing VS Code extensions
Using MCP servers, skills & extensions
Reference
REST API overview
Profile schema
Criteria schema
Prompt feature schema
Coding agents & capabilities
REST API reference
Overview
Keys
Preview key
List keys
Create key
Get key
Update key
Delete key
Validate key
Accounts
List accounts
Create account
Get account
Update account
Delete account
Health
Liveness probe
Readiness probe
System
API metadata
Version info
Projects
List all projects
Create a project
Get a project
Soft-delete a project
Update a project
Restore a soft-deleted project
Requests
List requests
Submit request(s)
List run filter facets
Get request
Soft-delete request
Compute pass@k / success@T metrics
Bulk resubmit requests
Bulk soft-delete requests
Download batch archive of multiple runs
Import run archive
Import batch run archive
List attempts for a request
Get a single attempt
Bulk retry requests (start new attempts)
Retry a request (start a new attempt)
Set priority on a single request
Set priority on multiple requests
Pause a single request
Resume a paused request
Pause multiple requests
Resume multiple paused requests
Cancel a request (marks as done/failed and signals worker to exit)
Cancel multiple requests
Stream request logs (SSE)
Stream logs for a specific attempt (SSE)
Download HAR file
Download HAR file for a specific attempt
Download ATIF trajectory file for a specific iteration
Download ATIF trajectory file for a specific attempt and iteration
Download session recording
Download session recording for a specific attempt
Download per-iteration tool-calls JSONL
Download per-iteration tool-calls JSONL for a specific attempt
Download iteration snapshot
Download iteration snapshot for a specific attempt
Download full run archive
Download full run archive for a specific attempt
Reports
Get reports for request
List reports
Create report
Bulk create reports
Bulk get report statuses
Bulk get report summary per run
Get report
Stream report logs (SSE)
Trigger reports
Bulk trigger reports
Get insights for report
Link insight to report
Criteria
Generate criterion prompt from behavior
Seed criteria in bulk
List criteria
Create criterion
Compute MDP transitions
Get criteria DAG
Get criterion
Update criterion
Soft-delete criterion
Prompt Features
Generate prompt feature from behavior
Seed prompt features in bulk
Extract features from text
List features
Create feature
Get feature
Update feature
Soft-delete feature
Task Prompts
Generate task prompts
List task prompts
Create or find task prompt
Get task prompt
Soft-delete task prompt
Get resolved task prompt content
Extract features from task prompt
Toggle feature flag on task prompt
Profiles
List profiles
Create a new profile
Get profile with latest version
Update profile identity
Create new profile version
Delete profile
List profile versions
Get profile version
Report Templates
Get default system prompt
List models available for report generation
List report templates
Create report template
Get report template
Update report template
Delete report template
Agents
List agents
Create or update agent (upsert)
Get agent
Update agent
Delete agent
List agent versions
Register agent version (upsert)
Patch agent version
Models
List models
Get model
Sync models from provider
MCP Servers
List MCP servers
Create MCP server
Get MCP server
Update MCP server
Delete MCP server
Skills
List all skills
Create or import a skill
Search skills (internal + external)
Search external skills registry
Discover skills in a GitHub repository
List skill revisions
Get skill by slug
Soft-delete a skill
Trigger skill resolution
Skill Revisions
Download skill revision archive
Get skill revision by ref
Get skill revision by ID
Codebases
List all codebases
Create a codebase (archive codebases require the archive file)
Get a codebase
Delete a codebase
Update a codebase
List codebase revisions
Resolve a new git codebase revision
Upload a codebase archive as a new revision
Codebase Revisions
Download codebase revision archive
Get codebase revision by id
Extensions
List all extensions
Create or import an extension
Search extensions (internal + marketplace)
Get extension by ID
Update extension
Delete extension
List available versions for an extension
Insights
List insights
Create insight
Search insights
Get insight
Update insight
Delete insight
Upvote insight
Downvote insight
Block insight
Unblock insight
Get reports referencing insight
Feature Flags
List feature flags
Update feature flag
Resources
FAQ
Data collection and privacy
Troubleshooting
Glossary
Select theme
Dark
Light
Auto
Overview
Scope API
1.0.0
Section titled “Scope API 1.0.0”
REST API for the Scope platform — benchmarking AI coding agents
Informations
OpenAPI version:
3.1.0
Operations
Section titled “ Operations ”
POST
/api/v1/keys/preview
GET
/api/v1/keys
POST
/api/v1/keys
GET
/api/v1/keys/{id}
PUT
/api/v1/keys/{id}
DELETE
/api/v1/keys/{id}
POST
/api/v1/keys/{id}/validate
GET
/api/v1/accounts
POST
/api/v1/accounts
GET
/api/v1/accounts/{id}
PUT
/api/v1/accounts/{id}
DELETE
/api/v1/accounts/{id}
GET
/health
GET
/ready
GET
/about
GET
/api/v1/version
GET
/api/v1/projects
POST
/api/v1/projects
GET
/api/v1/projects/{id}
DELETE
/api/v1/projects/{id}
PATCH
/api/v1/projects/{id}
POST
/api/v1/projects/{id}/restore
GET
/api/v1/requests
POST
/api/v1/requests
GET
/api/v1/requests/facets
GET
/api/v1/requests/{id}
DELETE
/api/v1/requests/{id}
GET
/api/v1/analysis
POST
/api/v1/requests/bulk-resubmit
DELETE
/api/v1/requests/bulk
POST
/api/v1/requests/archive
POST
/api/v1/runs/upload
POST
/api/v1/runs/upload-batch
GET
/api/v1/requests/{id}/runs
GET
/api/v1/requests/{id}/runs/{runId}
POST
/api/v1/requests/bulk-retry
POST
/api/v1/requests/{id}/retry
POST
/api/v1/requests/{id}/priority
POST
/api/v1/requests/bulk-priority
POST
/api/v1/requests/{id}/pause
POST
/api/v1/requests/{id}/resume
POST
/api/v1/requests/bulk-pause
POST
/api/v1/requests/bulk-resume
POST
/api/v1/requests/{id}/cancel
POST
/api/v1/requests/bulk-cancel
GET
/api/v1/requests/{id}/logs
GET
/api/v1/requests/{id}/runs/{runId}/logs
GET
/api/v1/requests/{id}/har
GET
/api/v1/requests/{id}/runs/{runId}/har
GET
/api/v1/requests/{id}/atif
GET
/api/v1/requests/{id}/runs/{runId}/atif
GET
/api/v1/requests/{id}/video
GET
/api/v1/requests/{id}/runs/{runId}/video
GET
/api/v1/requests/{id}/tool-calls
GET
/api/v1/requests/{id}/runs/{runId}/tool-calls
GET
/api/v1/requests/{id}/snapshots/{iteration}
GET
/api/v1/requests/{id}/runs/{runId}/snapshots/{iteration}
GET
/api/v1/requests/{id}/archive
GET
/api/v1/requests/{id}/runs/{runId}/archive
GET
/api/v1/requests/{id}/reports
GET
/api/v1/reports
POST
/api/v1/reports
POST
/api/v1/reports/bulk-create
POST
/api/v1/reports/bulk-status
POST
/api/v1/reports/bulk-summary
GET
/api/v1/reports/{id}
GET
/api/v1/reports/{id}/logs
POST
/api/v1/reports/trigger
POST
/api/v1/reports/bulk-trigger
GET
/api/v1/reports/{id}/insights
POST
/api/v1/reports/{id}/insights
POST
/api/v1/criteria/generate-prompt
POST
/api/v1/criteria/seed
GET
/api/v1/criteria
POST
/api/v1/criteria
GET
/api/v1/criteria/mdp
GET
/api/v1/criteria/graph
GET
/api/v1/criteria/{id}
PUT
/api/v1/criteria/{id}
DELETE
/api/v1/criteria/{id}
POST
/api/v1/prompt-features/generate-prompt
POST
/api/v1/prompt-features/seed
POST
/api/v1/prompt-features/extract-from-text
GET
/api/v1/prompt-features
POST
/api/v1/prompt-features
GET
/api/v1/prompt-features/{id}
PUT
/api/v1/prompt-features/{id}
DELETE
/api/v1/prompt-features/{id}
POST
/api/v1/task-prompts/generate
GET
/api/v1/task-prompts
POST
/api/v1/task-prompts
GET
/api/v1/task-prompts/{id}
DELETE
/api/v1/task-prompts/{id}
GET
/api/v1/task-prompts/{id}/content
POST
/api/v1/task-prompts/{id}/extract-features
PATCH
/api/v1/task-prompts/{id}/features/{featureId}
GET
/api/v1/profiles
POST
/api/v1/profiles
GET
/api/v1/profiles/{profileId}
PUT
/api/v1/profiles/{profileId}
POST
/api/v1/profiles/{profileId}
DELETE
/api/v1/profiles/{profileId}
GET
/api/v1/profiles/{profileId}/versions
GET
/api/v1/profiles/{profileId}/versions/{version}
GET
/api/v1/report-templates/default-system-prompt
GET
/api/v1/report-templates/available-models
GET
/api/v1/report-templates
POST
/api/v1/report-templates
GET
/api/v1/report-templates/{id}
PUT
/api/v1/report-templates/{id}
DELETE
/api/v1/report-templates/{id}
GET
/api/v1/agents
POST
/api/v1/agents
GET
/api/v1/agents/{id}
PUT
/api/v1/agents/{id}
DELETE
/api/v1/agents/{id}
GET
/api/v1/agents/{id}/versions
POST
/api/v1/agents/{id}/versions
PATCH
/api/v1/agents/{id}/versions/{agentVersion}
GET
/api/v1/models
GET
/api/v1/models/{id}
POST
/api/v1/models/sync
GET
/api/v1/mcp/servers
POST
/api/v1/mcp/servers
GET
/api/v1/mcp/servers/{id}
PUT
/api/v1/mcp/servers/{id}
DELETE
/api/v1/mcp/servers/{id}
GET
/api/v1/skills
POST
/api/v1/skills
GET
/api/v1/skills/search
GET
/api/v1/skills/search/external
GET
/api/v1/skills/discover
GET
/api/v1/skills/{id}(*)/revisions
GET
/api/v1/skills/{id}(*)
DELETE
/api/v1/skills/{id}(*)
POST
/api/v1/skills/{id}(*)/resolve
GET
/api/v1/skill-revisions/by-ref/{ref}(*)/archive
GET
/api/v1/skill-revisions/by-ref/{ref}(*)
GET
/api/v1/skill-revisions/{id}
GET
/api/v1/codebases
POST
/api/v1/codebases
GET
/api/v1/codebases/{id}
DELETE
/api/v1/codebases/{id}
PATCH
/api/v1/codebases/{id}
GET
/api/v1/codebases/{id}/revisions
POST
/api/v1/codebases/{id}/revisions
POST
/api/v1/codebases/{id}/upload
GET
/api/v1/codebase-revisions/{id}/archive
GET
/api/v1/codebase-revisions/{id}
GET
/api/v1/extensions
POST
/api/v1/extensions
GET
/api/v1/extensions/search
GET
/api/v1/extensions/{id}
PUT
/api/v1/extensions/{id}
DELETE
/api/v1/extensions/{id}
GET
/api/v1/extensions/{id}/versions
GET
/api/v1/insights
POST
/api/v1/insights
GET
/api/v1/insights/search
GET
/api/v1/insights/{id}
PUT
/api/v1/insights/{id}
DELETE
/api/v1/insights/{id}
POST
/api/v1/insights/{id}/upvote
POST
/api/v1/insights/{id}/downvote
POST
/api/v1/insights/{id}/block
POST
/api/v1/insights/{id}/unblock
GET
/api/v1/insights/{id}/reports
GET
/api/v1/feature-flags
PUT
/api/v1/feature-flags/{key}