Skip to Content
Judgment Labs

Ingest observations

POST
/v1/projects/{projectId}/observations

Record model calls in the conversation format without sending traces. Each call is stored in its conversation and evaluated by the project's conversation judges, as calls recorded from traces are. Send at most 100 observations per request. Retrying a request with the same observations and timestamps stores each call once.

Authorization

headerAuthorizationBearer <token>

An ingest API key from Settings > Ingest API Keys, sent as Bearer <key>. It belongs to one organization, so no X-Organization-Id is needed.

Path Parameters

projectId*string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$
Formatuuid

Request Body

application/json
  1. body
observations*array<>
Items1 <= items <= 100

Response Body

Response for status 200

application/json
  1. response
status*string
Example Request
curl -X POST 'https://api.judgmentlabs.ai/v1/projects/YOUR_PROJECT_ID/observations' \  -H 'Content-Type: application/json' \  -d '{  "observations": [    {      "observation": {        "conversation_id": "string",        "input": [          {            "type": "message",            "role": "system",            "content": [              {                "type": "text",                "text": "string"              }            ]          }        ]      },      "observed_at": "2019-08-24T14:15:22Z"    }  ]}'
Example Response200
{  "status": "success"}