Agents

Operations of the LLM Registry API. Paths are relative to your deployment's API host.

GET /api/llm-registry-api/authoring/agents

List stable Agents owned by the organization.

Authentication: bearer token (Authorization: Bearer <token>)

StatusDescriptionBody
200application/json AgentAuthoringResponseDtoDataArrayEnvelope
400application/problem+json ProblemDetailsDto
401application/problem+json ProblemDetailsDto
403application/problem+json ProblemDetailsDto
404application/problem+json ProblemDetailsDto
409application/problem+json ProblemDetailsDto
422application/problem+json ProblemDetailsDto
500application/problem+json ProblemDetailsDto

POST /api/llm-registry-api/authoring/agents

Create a stable Agent identity with one mutable draft.

Authentication: bearer token (Authorization: Bearer <token>)

Request body: application/json CreateAgentDto

StatusDescriptionBody
201application/json AgentAuthoringResponseDtoDataEnvelope
400application/problem+json ProblemDetailsDto
401application/problem+json ProblemDetailsDto
403application/problem+json ProblemDetailsDto
404application/problem+json ProblemDetailsDto
409application/problem+json ProblemDetailsDto
422application/problem+json ProblemDetailsDto
500application/problem+json ProblemDetailsDto

GET /api/llm-registry-api/authoring/agents/{identityId}

Get a stable Agent identity and current draft/stable ReleaseChannels.

Authentication: bearer token (Authorization: Bearer <token>)

ParameterInTypeRequiredDescription
identityIdpathstringyes
StatusDescriptionBody
200application/json AgentAuthoringResponseDtoDataEnvelope
400application/problem+json ProblemDetailsDto
401application/problem+json ProblemDetailsDto
403application/problem+json ProblemDetailsDto
404application/problem+json ProblemDetailsDto
409application/problem+json ProblemDetailsDto
422application/problem+json ProblemDetailsDto
500application/problem+json ProblemDetailsDto

DELETE /api/llm-registry-api/authoring/agents/{identityId}

Delete an Agent identity that has never been published.

Authentication: bearer token (Authorization: Bearer <token>)

ParameterInTypeRequiredDescription
identityIdpathstringyes
StatusDescriptionBody
400application/problem+json ProblemDetailsDto
401application/problem+json ProblemDetailsDto
403application/problem+json ProblemDetailsDto
404application/problem+json ProblemDetailsDto
409application/problem+json ProblemDetailsDto
422application/problem+json ProblemDetailsDto
500application/problem+json ProblemDetailsDto

PATCH /api/llm-registry-api/authoring/agents/{identityId}/draft

Update the mutable Agent draft with optimistic concurrency.

Authentication: bearer token (Authorization: Bearer <token>)

ParameterInTypeRequiredDescription
identityIdpathstringyes

Request body: application/json UpdateAgentDraftDto

StatusDescriptionBody
200application/json AgentAuthoringResponseDtoDataEnvelope
400application/problem+json ProblemDetailsDto
401application/problem+json ProblemDetailsDto
403application/problem+json ProblemDetailsDto
404application/problem+json ProblemDetailsDto
409application/problem+json ProblemDetailsDto
422application/problem+json ProblemDetailsDto
500application/problem+json ProblemDetailsDto

GET /api/llm-registry-api/authoring/agents/{identityId}/drafts

List the bounded ring of retained autosaved drafts.

Authentication: bearer token (Authorization: Bearer <token>)

ParameterInTypeRequiredDescription
identityIdpathstringyes
StatusDescriptionBody
200application/json AgentDraftRingEntryDtoDataArrayEnvelope
400application/problem+json ProblemDetailsDto
401application/problem+json ProblemDetailsDto
403application/problem+json ProblemDetailsDto
404application/problem+json ProblemDetailsDto
409application/problem+json ProblemDetailsDto
422application/problem+json ProblemDetailsDto
500application/problem+json ProblemDetailsDto

GET /api/llm-registry-api/authoring/agents/{identityId}/history

List immutable Agent revision history.

Authentication: bearer token (Authorization: Bearer <token>)

ParameterInTypeRequiredDescription
identityIdpathstringyes
StatusDescriptionBody
200application/json AgentRevisionHistoryEntryDtoDataArrayEnvelope
400application/problem+json ProblemDetailsDto
401application/problem+json ProblemDetailsDto
403application/problem+json ProblemDetailsDto
404application/problem+json ProblemDetailsDto
409application/problem+json ProblemDetailsDto
422application/problem+json ProblemDetailsDto
500application/problem+json ProblemDetailsDto

POST /api/llm-registry-api/authoring/agents/{identityId}/history/{revisionId}/restore

Copy an immutable historical revision into the mutable draft.

Authentication: bearer token (Authorization: Bearer <token>)

ParameterInTypeRequiredDescription
identityIdpathstringyes
revisionIdpathstringyes

Request body: application/json RestoreAgentRevisionDto

StatusDescriptionBody
200application/json AgentAuthoringResponseDtoDataEnvelope
400application/problem+json ProblemDetailsDto
401application/problem+json ProblemDetailsDto
403application/problem+json ProblemDetailsDto
404application/problem+json ProblemDetailsDto
409application/problem+json ProblemDetailsDto
422application/problem+json ProblemDetailsDto
500application/problem+json ProblemDetailsDto

POST /api/llm-registry-api/authoring/agents/{identityId}/publish

Publish the current draft as the next generated immutable revision.

Authentication: bearer token (Authorization: Bearer <token>)

ParameterInTypeRequiredDescription
identityIdpathstringyes

Request body: application/json PublishAgentRevisionDto

StatusDescriptionBody
201application/json AgentAuthoringResponseDtoDataEnvelope
400application/problem+json ProblemDetailsDto
401application/problem+json ProblemDetailsDto
403application/problem+json ProblemDetailsDto
404application/problem+json ProblemDetailsDto
409application/problem+json ProblemDetailsDto
422application/problem+json ProblemDetailsDto
500application/problem+json ProblemDetailsDto

POST /api/llm-registry-api/authoring/agents/{identityId}/revisions/pins/move

Move mutable revision pins between two revisions of one Agent.

Authentication: bearer token (Authorization: Bearer <token>)

ParameterInTypeRequiredDescription
identityIdpathstringyes

Request body: application/json MoveRevisionPinsDto

StatusDescriptionBody
200application/json RevisionPinMovePlanDtoDataEnvelope
400application/problem+json ProblemDetailsDto
401application/problem+json ProblemDetailsDto
403application/problem+json ProblemDetailsDto
404application/problem+json ProblemDetailsDto
409application/problem+json ProblemDetailsDto
422application/problem+json ProblemDetailsDto
500application/problem+json ProblemDetailsDto

GET /api/llm-registry-api/authoring/agents/{identityId}/revisions/{revisionId}/pins

List every consumer pinned to one Agent revision.

Authentication: bearer token (Authorization: Bearer <token>)

ParameterInTypeRequiredDescription
identityIdpathstringyes
revisionIdpathstringyes
StatusDescriptionBody
200application/json RevisionPinDtoDataArrayEnvelope
400application/problem+json ProblemDetailsDto
401application/problem+json ProblemDetailsDto
403application/problem+json ProblemDetailsDto
404application/problem+json ProblemDetailsDto
409application/problem+json ProblemDetailsDto
422application/problem+json ProblemDetailsDto
500application/problem+json ProblemDetailsDto

POST /api/llm-registry-api/authoring/agents/{identityId}/rollback

Replay a prior immutable stable ReleaseSet under channel CAS.

Authentication: bearer token (Authorization: Bearer <token>)

ParameterInTypeRequiredDescription
identityIdpathstringyes

Request body: application/json RollbackAgentRevisionDto

StatusDescriptionBody
200application/json AgentRollbackResponseDtoDataEnvelope
400application/problem+json ProblemDetailsDto
401application/problem+json ProblemDetailsDto
403application/problem+json ProblemDetailsDto
404application/problem+json ProblemDetailsDto
409application/problem+json ProblemDetailsDto
422application/problem+json ProblemDetailsDto
500application/problem+json ProblemDetailsDto