Skip to main content
POST
Publish Disposition Extractor

Overview

Dispositions are enabled per organization. If your organization does not have access, these endpoints return 404.
Validates the editable draft, moves it to the archived state as the extractor’s new activeVersionId, and opens a fresh editable copy with the next versionNumber as the new currentVersionId. The published version is immutable and appears in Get Extractor Catalog, where a disposition value can pin it. Dispositions that already pinned an earlier version keep running that version. Requires an admin, owner, operator, or prompter role.

Headers

string
required
Your API key for authentication.

Path Parameters

string
required
The agent’s unique identifier. A malformed id returns 400 with the message agentId must be a valid UUID.
string
required
The extractor’s unique identifier. Must be organization-wide or scoped to this agent; otherwise returns 404 with the message Disposition extractor not found. A malformed id returns 400 with the message extractorId must be a valid UUID.

Body Parameters

Unknown fields are rejected and return 400 with the message Invalid request body. If the draft fails the same prompt, schema, or model-profile rules as Create Disposition Extractor, the request returns 400 with the message Extractor definition failed validation and nothing is published.
string
required
The extractor’s current currentVersionId, the draft being published. If another update or publish has moved it, the request returns 409 CONFLICT with the message Extractor draft changed; refresh and try again.
integer
required
The extractor’s current draftRevision. Minimum 1. A stale value returns the same 409 CONFLICT.

Response

object
The extractor record after publishing. activeVersionId now points at data.publishedVersion.id, currentVersionId at data.currentVersion.id, and draftRevision has incremented by 1.
object
The version that was just published, now archived and immutable.
object
The new editable draft, a copy of the published version with versionNumber incremented by 1. Same fields as data.publishedVersion, with state set to editable.
null | array
null on success, or a list of error objects if the request failed.

Docs for agents: llms.txt