Skip to main content
POST
/
reports
/
{report_id}
/
external-ids
Attach Report External ID
curl --request POST \
  --url https://api.promptlayer.com/reports/{report_id}/external-ids \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "source": "<string>",
  "external_id": "<string>"
}
'
{
  "success": true,
  "external_id": {
    "source": "<string>",
    "external_id": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://promptlayer-add-demo-projects.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Attach a {source, external_id} mapping to an existing report or evaluation pipeline. Attaching the same mapping to the same report is idempotent. Reusing the mapping on another entity returns 409 Conflict. See External IDs.

Authorizations

​
X-API-KEY
string
header
required

Path Parameters

​
report_id
integer
required

Body

application/json

External ID mapping to attach to an entity.

​
source
string
required

The external system or namespace that owns the ID.

Required string length: 1 - 128
​
external_id
string
required

The identifier for this entity in the external system.

Required string length: 1 - 512

Response

External ID attached

​
success
boolean
default:true
required
​
external_id
ExternalId · object
required

Customer-defined mapping between a PromptLayer entity and an external system identifier.