Trajectory Experiments API
The experiments API from Trajectory — 13 operation(s) for experiments.
The experiments API from Trajectory — 13 operation(s) for experiments.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/trajectory:trajectory-experiments-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Trajectory Experiments API
version: 0.1.0
x-trajectory-api-version: '2026-10-14'
description: This contract is API version 2026-10-14. The optional Trajectory-API-Version header pins it, and tmp-contract is accepted as an alias. Requests without the header get this version. Version 2026-10-07 and the pre-launch legacy response formats are retired.
tags:
- name: Experiments
paths:
/api/v1/experiments:
get:
tags:
- Experiments
summary: List Experiments
operationId: listExperiments
parameters:
- name: xids
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Comma-separated exact XIDs to fetch.
title: Xids
description: Comma-separated exact XIDs to fetch.
- name: xid_prefix
in: query
required: false
schema:
anyOf:
- type: string
maxLength: 256
pattern: ^[0-9]+$
- type: 'null'
description: Return experiments matching a numeric XID prefix, ordered by XID ascending.
title: Xid Prefix
description: Return experiments matching a numeric XID prefix, ordered by XID ascending.
- name: after
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Only experiments created at or after this timestamp.
title: After
description: Only experiments created at or after this timestamp.
- name: before
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Only experiments created at or before this timestamp.
title: Before
description: Only experiments created at or before this timestamp.
- name: experiment_name
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Case-insensitive experiment name substring.
title: Experiment Name
description: Case-insensitive experiment name substring.
- name: user
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Filter by display user, email, or user id.
title: User
description: Filter by display user, email, or user id.
- name: status
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Filter by raw experiment status.
title: Status
description: Filter by raw experiment status.
- name: config_query
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Filter by config path equality or substring.
title: Config Query
description: Filter by config path equality or substring.
- name: cursor
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Cursor
- name: limit
in: query
required: false
schema:
type: integer
maximum: 200
minimum: 1
default: 25
title: Limit
- name: sort
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Sort
- name: order
in: query
required: false
schema:
enum:
- asc
- desc
type: string
default: desc
title: Order
- name: search
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Search
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/PaginatedResponse_ExperimentSummary_'
x-trajectory-visibility: browser
/api/v1/experiments/{xid}:
get:
tags:
- Experiments
summary: Get Experiment
operationId: getExperiment
parameters:
- name: xid
in: path
required: true
schema:
type: string
title: Xid
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ExperimentDetail'
x-trajectory-visibility: browser
/api/v1/experiments/{xid}/notes:
get:
tags:
- Experiments
summary: List Experiment Notes
operationId: listExperimentNotes
parameters:
- name: xid
in: path
required: true
schema:
type: string
title: Xid
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ExperimentNoteListResponse'
x-trajectory-visibility: browser
post:
tags:
- Experiments
summary: Create Experiment Note
operationId: createExperimentNote
parameters:
- name: xid
in: path
required: true
schema:
type: string
title: Xid
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CreateExperimentNoteRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ExperimentNoteResponse'
x-trajectory-visibility: browser
/api/v1/experiments/{xid}/notes/{note_id}:
delete:
tags:
- Experiments
summary: Delete Experiment Note
operationId: deleteExperimentNote
parameters:
- name: xid
in: path
required: true
schema:
type: string
title: Xid
- name: note_id
in: path
required: true
schema:
type: string
title: Note Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/DeleteExperimentNoteResponse'
x-trajectory-visibility: browser
/api/v1/experiment-notes/counts:
get:
tags:
- Experiments
summary: Get Experiment Note Counts
operationId: getExperimentNoteCounts
parameters:
- name: xids
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: Comma-separated XIDs to count notes for.
title: Xids
description: Comma-separated XIDs to count notes for.
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ExperimentNoteCountsResponse'
x-trajectory-visibility: browser
/api/v1/experiment-groups:
get:
tags:
- Experiments
summary: List Experiment Groups
operationId: listExperimentGroups
parameters:
- name: cursor
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Cursor
- name: limit
in: query
required: false
schema:
type: integer
maximum: 200
minimum: 1
default: 25
title: Limit
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ExperimentGroupListResponse'
x-trajectory-visibility: browser
post:
tags:
- Experiments
summary: Create Experiment Group
operationId: createExperimentGroup
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CreateExperimentGroupRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ExperimentGroupResponse'
x-trajectory-visibility: browser
/api/v1/experiment-groups/{group_id}:
patch:
tags:
- Experiments
summary: Update Experiment Group
operationId: updateExperimentGroup
parameters:
- name: group_id
in: path
required: true
schema:
type: string
title: Group Id
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateExperimentGroupRequest'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ExperimentGroupResponse'
x-trajectory-visibility: browser
delete:
tags:
- Experiments
summary: Delete Experiment Group
operationId: deleteExperimentGroup
parameters:
- name: group_id
in: path
required: true
schema:
type: string
title: Group Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/DeleteExperimentGroupResponse'
x-trajectory-visibility: browser
/api/v1/experiment-groups/{group_id}/experiments:
get:
tags:
- Experiments
summary: List Experiment Group Experiments
operationId: listExperimentGroupExperiments
parameters:
- name: group_id
in: path
required: true
schema:
type: string
title: Group Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ExperimentGroupExperimentsResponse'
x-trajectory-visibility: browser
/api/v1/experiments/{xid}/code/manifest:
get:
tags:
- Experiments
summary: Get Code Manifest
operationId: getExperimentCodeManifest
parameters:
- name: xid
in: path
required: true
schema:
type: string
title: Xid
responses:
'200':
description: Successful Response
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/CapturedCodeManifest'
- $ref: '#/components/schemas/UncapturedCodeManifest'
discriminator:
propertyName: captured
mapping:
'True': '#/components/schemas/CapturedCodeManifest'
'False': '#/components/schemas/UncapturedCodeManifest'
title: Response Getexperimentcodemanifest
x-trajectory-visibility: browser
/api/v1/experiments/{xid}/code/patch:
get:
tags:
- Experiments
summary: Get Code Patch
operationId: getExperimentCodePatch
parameters:
- name: xid
in: path
required: true
schema:
type: string
title: Xid
responses:
'200':
description: The launch diff; apply with `git apply --binary` on the base commit.
content:
text/x-patch:
schema:
type: string
format: binary
x-trajectory-visibility: browser
/api/v1/experiments/{xid}/code/file-diff:
get:
tags:
- Experiments
summary: Get Code File Diff
operationId: getExperimentCodeFileDiff
parameters:
- name: xid
in: path
required: true
schema:
type: string
title: Xid
- name: path
in: query
required: false
schema:
type: string
default: ''
title: Path
responses:
'200':
description: Successful Response
content:
text/plain:
schema:
type: string
x-trajectory-visibility: browser
/api/v1/experiments/{xid}/code/raw:
get:
tags:
- Experiments
summary: Get Code Raw File
operationId: getExperimentCodeRawFile
parameters:
- name: xid
in: path
required: true
schema:
type: string
title: Xid
- name: path
in: query
required: false
schema:
type: string
default: ''
title: Path
responses:
'200':
description: The file as launched.
content:
application/octet-stream:
schema:
type: string
format: binary
x-trajectory-visibility: browser
/api/v1/experiments/{xid}/code/submodule-patch:
get:
tags:
- Experiments
summary: Get Code Submodule Patch
operationId: getExperimentCodeSubmodulePatch
parameters:
- name: xid
in: path
required: true
schema:
type: string
title: Xid
- name: path
in: query
required: false
schema:
type: string
default: ''
title: Path
responses:
'200':
description: Successful Response
content:
text/plain:
schema:
type: string
x-trajectory-visibility: browser
components:
schemas:
DeleteExperimentGroupResponse:
properties:
success:
type: boolean
title: Success
type: object
required:
- success
title: DeleteExperimentGroupResponse
CodeStateOmittedDir:
properties:
path:
type: string
title: Path
files:
type: integer
title: Files
additionalProperties: true
type: object
required:
- path
- files
title: CodeStateOmittedDir
ExperimentDetail:
properties:
xid:
type: string
title: Xid
experiment_name:
anyOf:
- type: string
- type: 'null'
title: Experiment Name
user_email:
anyOf:
- type: string
- type: 'null'
title: User Email
user_id:
anyOf:
- type: string
- type: 'null'
title: User Id
user:
anyOf:
- type: string
- type: 'null'
title: User
status:
anyOf:
- type: string
- type: 'null'
title: Status
is_externally_visible:
type: boolean
title: Is Externally Visible
default: false
created_at:
anyOf:
- type: string
- type: 'null'
title: Created At
updated_at:
anyOf:
- type: string
- type: 'null'
title: Updated At
git_sha:
anyOf:
- type: string
- type: 'null'
title: Git Sha
git_base_sha:
anyOf:
- type: string
- type: 'null'
title: Git Base Sha
wandb_url:
anyOf:
- type: string
- type: 'null'
title: Wandb Url
aim_url:
anyOf:
- type: string
- type: 'null'
title: Aim Url
tempo_url:
anyOf:
- type: string
- type: 'null'
title: Tempo Url
pyroscope_url:
anyOf:
- type: string
- type: 'null'
title: Pyroscope Url
logging_url:
anyOf:
- type: string
- type: 'null'
title: Logging Url
started_at:
anyOf:
- type: string
- type: 'null'
title: Started At
ended_at:
anyOf:
- type: string
- type: 'null'
title: Ended At
error_message:
anyOf:
- type: string
- type: 'null'
title: Error Message
job_type:
anyOf:
- type: string
- type: 'null'
title: Job Type
kubernetes_job_name:
anyOf:
- type: string
- type: 'null'
title: Kubernetes Job Name
cpu_kubernetes_job_name:
anyOf:
- type: string
- type: 'null'
title: Cpu Kubernetes Job Name
cpu_cluster_name:
anyOf:
- type: string
- type: 'null'
title: Cpu Cluster Name
tcli_gpu_cluster_name:
anyOf:
- type: string
- type: 'null'
title: Tcli Gpu Cluster Name
training_backend_mode:
anyOf:
- type: string
- type: 'null'
title: Training Backend Mode
cost_status:
anyOf:
- type: string
- type: 'null'
title: Cost Status
cost_total_usd:
anyOf:
- type: number
- type: 'null'
title: Cost Total Usd
cost_breakdown:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Cost Breakdown
runner:
anyOf:
- type: string
- type: 'null'
title: Runner
entry_type:
anyOf:
- type: string
- type: 'null'
title: Entry Type
autoresearch_ui_url:
anyOf:
- type: string
- type: 'null'
title: Autoresearch Ui Url
code_state_uri:
anyOf:
- type: string
- type: 'null'
title: Code State Uri
config:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Config
metadata:
additionalProperties: true
type: object
title: Metadata
type: object
required:
- xid
title: ExperimentDetail
description: A single experiment with its full config + metadata field bag.
DeleteExperimentNoteResponse:
properties:
success:
type: boolean
title: Success
type: object
required:
- success
title: DeleteExperimentNoteResponse
ExperimentSummary:
properties:
xid:
type: string
title: Xid
experiment_name:
anyOf:
- type: string
- type: 'null'
title: Experiment Name
user_email:
anyOf:
- type: string
- type: 'null'
title: User Email
user_id:
anyOf:
- type: string
- type: 'null'
title: User Id
user:
anyOf:
- type: string
- type: 'null'
title: User
status:
anyOf:
- type: string
- type: 'null'
title: Status
is_externally_visible:
type: boolean
title: Is Externally Visible
default: false
created_at:
anyOf:
- type: string
- type: 'null'
title: Created At
updated_at:
anyOf:
- type: string
- type: 'null'
title: Updated At
git_sha:
anyOf:
- type: string
- type: 'null'
title: Git Sha
git_base_sha:
anyOf:
- type: string
- type: 'null'
title: Git Base Sha
wandb_url:
anyOf:
- type: string
- type: 'null'
title: Wandb Url
aim_url:
anyOf:
- type: string
- type: 'null'
title: Aim Url
tempo_url:
anyOf:
- type: string
- type: 'null'
title: Tempo Url
pyroscope_url:
anyOf:
- type: string
- type: 'null'
title: Pyroscope Url
logging_url:
anyOf:
- type: string
- type: 'null'
title: Logging Url
started_at:
anyOf:
- type: string
- type: 'null'
title: Started At
ended_at:
anyOf:
- type: string
- type: 'null'
title: Ended At
error_message:
anyOf:
- type: string
- type: 'null'
title: Error Message
job_type:
anyOf:
- type: string
- type: 'null'
title: Job Type
kubernetes_job_name:
anyOf:
- type: string
- type: 'null'
title: Kubernetes Job Name
cpu_kubernetes_job_name:
anyOf:
- type: string
- type: 'null'
title: Cpu Kubernetes Job Name
cpu_cluster_name:
anyOf:
- type: string
- type: 'null'
title: Cpu Cluster Name
tcli_gpu_cluster_name:
anyOf:
- type: string
- type: 'null'
title: Tcli Gpu Cluster Name
training_backend_mode:
anyOf:
- type: string
- type: 'null'
title: Training Backend Mode
cost_status:
anyOf:
- type: string
- type: 'null'
title: Cost Status
cost_total_usd:
anyOf:
- type: number
- type: 'null'
title: Cost Total Usd
cost_breakdown:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Cost Breakdown
runner:
anyOf:
- type: string
- type: 'null'
title: Runner
entry_type:
anyOf:
- type: string
- type: 'null'
title: Entry Type
autoresearch_ui_url:
anyOf:
- type: string
- type: 'null'
title: Autoresearch Ui Url
code_state_uri:
anyOf:
- type: string
- type: 'null'
title: Code State Uri
type: object
required:
- xid
title: ExperimentSummary
description: A single experiment row as returned by the list endpoint (no config blob).
PaginatedResponse_ExperimentSummary_:
properties:
items:
items:
$ref: '#/components/schemas/ExperimentSummary'
type: array
title: Items
next_cursor:
anyOf:
- type: string
- type: 'null'
title: Next Cursor
has_more:
type: boolean
title: Has More
type: object
required:
- items
- has_more
title: PaginatedResponse[ExperimentSummary]
ExperimentGroupListResponse:
properties:
items:
items:
$ref: '#/components/schemas/ExperimentGroup'
type: array
title: Items
next_cursor:
anyOf:
- type: string
- type: 'null'
title: Next Cursor
has_more:
type: boolean
title: Has More
type: object
required:
- items
- has_more
title: ExperimentGroupListResponse
ExperimentGroup:
properties:
id:
type: string
title: Id
name:
type: string
title: Name
created_by:
type: string
title: Created By
created_at:
type: string
format: date-time
title: Created At
xids:
items:
type: string
type: array
title: Xids
type: object
required:
- id
- name
- created_by
- created_at
- xids
title: ExperimentGroup
CodeStateFile:
properties:
path:
type: string
title: Path
old_path:
anyOf:
- type: string
- type: 'null'
title: Old Path
status:
type: string
enum:
- added
- modified
- deleted
- renamed
title: Status
additions:
type: integer
title: Additions
deletions:
type: integer
title: Deletions
byte_size:
type: integer
title: Byte Size
is_binary:
type: boolean
title: Is Binary
patch_start:
type: integer
title: Patch Start
patch_end:
type: integer
title: Patch End
additionalProperties: true
type: object
required:
- path
- status
- additions
- deletions
- byte_size
- is_binary
- patch_start
- patch_end
title: CodeStateFile
description: One changed file; its diff is bytes [patch_start, patch_end) of diff.patch.
ExperimentNote:
properties:
id:
type: string
title: Id
xid:
type: string
title: Xid
text:
type: string
title: Text
created_by:
type: string
title: Created By
created_at:
type: string
format: date-time
title: Created At
type: object
required:
- id
- xid
- text
- created_by
- created_at
title: ExperimentNote
UpdateExperimentGroupRequest:
properties:
name:
anyOf:
- type: string
- type: 'null'
title: Name
add_xids:
items:
type: string
type: array
title: Add Xids
default: []
remove_xids:
items:
type: string
type: array
title: Remove Xids
default: []
type: object
title: UpdateExperimentGroupRequest
CodeStateOmittedFile:
properties:
path:
type: string
title: Path
bytes:
type: integer
title: Bytes
additionalProperties: true
type: object
required:
- path
- bytes
title: CodeStateOmittedFile
UncapturedCodeManifest:
properties:
captured:
type: boolean
const: false
title: Captured
tarball_uri:
type: string
title: Tarball Uri
type: object
required:
- captured
- tarball_uri
title: UncapturedCodeManifest
description: An XID launched before provenance capture; only its code tarball exists.
ExperimentNoteListResponse:
properties:
notes:
items:
$ref: '#/components/schemas/ExperimentNote'
type: array
title: Notes
type: object
required:
- notes
title: ExperimentNoteListResponse
CodeStateSubmodule:
properties:
path:
type: string
title: Path
base_sha:
type: string
title: Base Sha
head_sha:
type: string
title: Head Sha
dirty:
type: boolean
title: Dirty
files:
items:
$ref: '#/components/schemas/CodeStateFile'
type: array
title: Files
patch_bytes:
type: integer
title: Patch Bytes
additionalProperties: true
type: object
required:
- path
- base_sha
- head_sha
- dirty
- files
- patch_bytes
title: CodeStateSubmodule
description: A checked-out submodule whose worktree differed from its pinned base.
CreateExperimentNoteRequest:
properties:
text:
type: string
title: Text
type: object
required:
- text
title: CreateExperimentNoteRequest
ExperimentNoteResponse:
properties:
note:
$ref: '#/components/schemas/ExperimentNote'
type: object
required:
- note
title: ExperimentNoteResponse
CapturedCodeManifest:
properties:
version:
type: integer
title: Version
xid:
type: string
title: Xid
branch:
type: string
title: Branch
base_sha:
type: string
title: Base Sha
head_sha:
type: string
title: Head Sha
captured_at:
type: string
title: Captured At
patch_bytes:
type: integer
title: Patch Bytes
files:
items:
$ref: '#/components/schemas/CodeStateFile'
type: array
title: Files
backfilled:
anyOf:
- type: boolean
- type: 'null'
title: Backfilled
omitted_dirs:
anyOf:
- items:
$ref: '#/components/schemas/CodeStateOmittedDir'
type: array
- type: 'null'
title: Omitted Dirs
omitted_files:
anyOf:
- items:
$ref: '#/components/schemas/CodeStateOmittedFile'
type: array
- type: 'null'
title: Omitted Files
submodules:
anyOf:
- items:
$ref: '#/components/schemas/CodeStateSubmodule'
type: array
- type: 'null'
title: Submodules
captured:
type: boolean
const: true
title: Captured
tarball_uri:
type: string
title: Tarball Uri
additionalProperties: true
type: object
required:
- version
- xid
- branch
- base_sha
- head_sha
- captured_at
- patch_bytes
- files
- captured
- tarball_uri
title: CapturedCodeManifest
ExperimentGroupExperimentsResponse:
properties:
experiments:
items:
$ref: '#/components/schemas/ExperimentSummary'
type: array
title: Experiments
type: object
required:
- experiments
title: ExperimentGroupExperimentsResponse
ExperimentNoteCountsResponse:
properties:
counts:
additionalProperties:
type: integer
type: object
title: Counts
type: object
required:
- counts
title: ExperimentNoteCountsResponse
CreateExperimentGroupRequest:
properties:
name:
type: string
title: Name
type: object
required:
- name
title: CreateExperimentGroupRequest
ExperimentGroupResponse:
properties:
group:
$ref: '#/components/schemas/ExperimentGroup'
type: object
required:
- group
title: ExperimentGroupResponse
securitySchemes:
TrajectoryAccessToken:
type: http
description: Short-lived token scoped to one rollout trajectory
scheme: bearer
InferenceAuthorization:
type: http
scheme: bearer