Tool Profiles

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

GET /api/llm-registry-api/agents/{slug}/tool-profiles

List tool profiles for an agent (all scopes merged). Biome-attributed rows are filtered through @xemahq/biome-governance-client against the caller org's enablement view.

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

ParameterInTypeRequiredDescription
slugpathstringyes
StatusDescriptionBody
200application/json ToolProfileResponseDtoDataArrayEnvelope
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/agents/{slug}/tool-profiles/resolved

Resolve effective tool profiles for an agent

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

ParameterInTypeRequiredDescription
slugpathstringyes
StatusDescriptionBody
200application/json ResolvedToolProfileDtoDataArrayEnvelope
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

PUT /api/llm-registry-api/agents/{slug}/tool-profiles/{mcpServiceKey}

Upsert a tool profile for an agent + MCP service key

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

ParameterInTypeRequiredDescription
mcpServiceKeypathstringyes
slugpathstringyes

Request body: application/json UpsertToolProfileDto

StatusDescriptionBody
200application/json ToolProfileResponseDtoDataEnvelope
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/agents/{slug}/tool-profiles/{mcpServiceKey}

Delete an org-scoped tool profile

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

ParameterInTypeRequiredDescription
mcpServiceKeypathstringyes
slugpathstringyes
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

PUT /api/llm-registry-api/tool-profiles/{id}/rescope

Re-scope a tool profile — promote its owner UP the scope ladder (the "add to project" / "publish to org" action). Legal promotions: user → project|org, project → org. Illegal promotions and non-owner attempts fail fast with 400/403.

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

ParameterInTypeRequiredDescription
idpathstringyes

Request body: application/json RescopeDto

StatusDescriptionBody
200application/json ToolProfileResponseDtoDataEnvelope
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