ai-tracking

Queue an AI tracking run

Changed on Oct 19, 2026

post/projects/{project_id}/ai-tracking/runs

Request

Base URL: https://eu.bisibility.com/api/v1
URL: https://eu.bisibility.com/api/v1/projects/{project_id}/ai-tracking/runs
Auth: one of:
- HTTP bearer
- HTTP bearer
- OAuth 2 (authorization code, authorization URL /api/auth/oauth2/authorize, token URL /api/auth/oauth2/token, scopes: api:write)

Path parameters

project_idstring required

Example:prj_a00000000000000000000000

Headers

Bisibility-API-Version'v1'

API contract version requested by the client. Omit this header to use the current backward-compatible behavior.

Idempotency-Keystring required

X-Bisibility-Source'sdk' | 'cli' | 'mcp'

Declares the client that produced the request for usage reporting: sdk, cli or mcp. Optional; any other value counts as api. It never changes authentication or which budget applies (every bearer-authenticated request counts against the API, MCP and SDK budget).

Request body

prompt_idsstring[] required

credential_connection_idstring required

Public connection ID resolved within the project.

credential_versionstring required

budget_revisionstring required

consent_revisionstring required

consenttrue required

deadlinestring date-time required

schedule_idstring

Public schedule ID resolved within the project.

planned_atstring date-time

retry_of_run_idstring

Compatibility plan field forwarded to the planner.

Example request

{
  "prompt_ids": [
    "aip_a00000000000000000000000"
  ],
  "credential_connection_id": "conn_a00000000000000000000000",
  "schedule_id": "ais_a00000000000000000000000"
}

Response

Project-scoped tracking data with retained provenance and explicit unknown measurements.

Changes

Oct 19, 2026a6e1ec0dec82 Revision changes
- breaking
  for the header request parameter Idempotency-Key, the minLength was increased from 0 to 1
- breaking
  request property // list-of-types was narrowed by removing types null from media type application/json
- breaking
  the request property's minLength was increased from 0 to 1
- breaking
  the / request property's minLength was increased from 0 to 1
- breaking
  removed the media type application/json for the response with the status
- warning
  the // request property's maxLength was set to 256
- info
  the endpoint scheme security AppOAuth was added to the API
- info
  added the new optional request property
- info
  the request property // became nullable
- info
  removed the pattern ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ from the request property
- info
  removed the pattern ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ from the request property
- info
  removed 'propertyNames' constraint from the request property //
- info
  media type application/json was changed to a more specific media type application/problem+json for the response status
- info
  media type application/json was changed to a more specific media type application/problem+json for the response status
- info
  media type application/json was changed to a more specific media type application/problem+json for the response status
- info
  media type application/json was changed to a more specific media type application/problem+json for the response status
- info
  media type application/json was changed to a more specific media type application/problem+json for the response status
- info
  media type application/json was changed to a more specific media type application/problem+json for the response status
- info
  media type application/json was changed to a more specific media type application/problem+json for the response status

Operation history