Agents

Find the run that produced a given external reference URL

Changed on

Reverse-looks up the agent run that created an external reference with the given URL. The URL is matched against the canonical locator stored when the artifact was reported. Returns 404 when no matching run exists or when the caller lacks access.

get/agent/run-by-external-reference

Request

  • Base URL
    https://app.warp.dev/api/v1
  • Auth
    HTTP bearer

Query parameters

urlstring required

The canonical URL of the external reference artifact to look up.

Response

Run found

run_idstring required

The ID of the run that produced the external reference.

Changes