> ## Documentation Index > Fetch the complete documentation index at: https://docs.trajectory.ai/llms.txt > Use this file to discover all available pages before exploring further. # Update an agent > Change an agent’s name or description. ## OpenAPI ````yaml /openapi.json patch /api/v1/agents/{agent_id} openapi: 3.1.0 info: title: Trajectory API version: 0.1.0 x-trajectory-api-version: '2026-10-14' description: >- This contract is API version 2026-10-14. The optional Trajectory-API-Version header pins it, and tmp-contract is accepted as an alias. Requests without the header get this version. Version 2026-10-07 and the pre-launch legacy response formats are retired. servers: - url: https://api.trajectory.ai security: [] tags: - name: agents x-group: Agents - name: benchmarks x-group: Specs (benchmarks) - name: diagnostics x-group: Diagnostics - name: benchmark-ingestion x-group: Spec (benchmark) submissions - name: eval x-group: Evaluations - name: training x-group: Training - name: deployments x-group: Deployments - name: model-endpoints x-group: Model endpoints - name: inference x-group: Inference - name: trajectories x-group: Trajectories - name: artifacts x-group: Artifacts - name: telemetry x-group: Telemetry - name: supported-models x-group: Supported models - name: organizations x-group: Organizations - name: secrets x-group: Secrets paths: /api/v1/agents/{agent_id}: patch: tags: - agents summary: Update an agent description: Change an agent’s name or description. operationId: updateAgent parameters: - name: agent_id in: path required: true schema: type: string title: Agent Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/UpdateAgentRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/AgentResponse' '404': description: >- The requested resource does not exist or is not visible to the caller. headers: X-Request-ID: $ref: '#/components/headers/RequestId' Trajectory-Should-Retry: $ref: '#/components/headers/TrajectoryShouldRetry' Retry-After: $ref: '#/components/headers/RetryAfter' content: application/json: schema: $ref: '#/components/schemas/ResourceNotFoundErrorResponse' '409': description: >- Another agent in the organization already uses the requested name. | The operation conflicts with the current state or an idempotent request. headers: X-Request-ID: $ref: '#/components/headers/RequestId' Trajectory-Should-Retry: $ref: '#/components/headers/TrajectoryShouldRetry' Retry-After: $ref: '#/components/headers/RetryAfter' content: application/json: schema: $ref: '#/components/schemas/UpdateAgentErrorResponse' default: $ref: '#/components/responses/ApiErrorResponse' security: - ApiKeyAuth: [] components: schemas: UpdateAgentRequest: properties: name: type: string maxLength: 256 pattern: ^[A-Za-z0-9 ._-]+$ title: Name description: >- New agent name using only letters, digits, spaces, hyphens, underscores, and periods. Omit to leave unchanged. description: anyOf: - type: string maxLength: 1024 - type: 'null' title: Description description: >- New agent description. Set to null to clear it; omit to leave unchanged. additionalProperties: false type: object minProperties: 1 title: UpdateAgentRequest AgentResponse: properties: agent_id: type: string maxLength: 64 title: Agent Id description: Stable identifier for the agent. organization_id: type: string title: Organization Id description: Organization that owns the agent. name: type: string title: Name description: Human-readable agent name. description: anyOf: - type: string - type: 'null' title: Description description: Optional description of the agent's purpose. created_at: type: string format: date-time title: Created At description: Time the agent was created. updated_at: type: string format: date-time title: Updated At description: Time the agent was last updated. benchmark_count: type: integer minimum: 0 title: Benchmark Count description: Number of benchmark snapshots owned by the agent. production_model_slug: anyOf: - type: string - type: 'null' title: Production Model Slug description: The agent production model slug; independent of its display name. type: object required: - agent_id - organization_id - name - created_at - updated_at - benchmark_count - production_model_slug title: AgentResponse ResourceNotFoundErrorResponse: properties: error: $ref: '#/components/schemas/ResourceNotFoundErrorBody' type: object required: - error title: ResourceNotFoundErrorResponse UpdateAgentErrorResponse: properties: error: oneOf: - $ref: '#/components/schemas/AgentNameConflictErrorBody' - $ref: '#/components/schemas/ConflictErrorBody' title: Error discriminator: propertyName: code mapping: agent_name_conflict: '#/components/schemas/AgentNameConflictErrorBody' conflict: '#/components/schemas/ConflictErrorBody' type: object required: - error title: UpdateAgentErrorResponse ResourceNotFoundErrorBody: properties: type: type: string const: invalid_request_error title: Type code: type: string const: resource_not_found title: Code message: type: string title: Message param: anyOf: - type: string - type: 'null' title: Param doc_url: type: string title: Doc Url context: $ref: '#/components/schemas/EmptyErrorContext' type: object required: - type - code - message - doc_url - context title: ResourceNotFoundErrorBody AgentNameConflictErrorBody: properties: type: type: string const: conflict_error title: Type code: type: string const: agent_name_conflict title: Code message: type: string title: Message param: anyOf: - type: string - type: 'null' title: Param doc_url: type: string title: Doc Url context: $ref: '#/components/schemas/EmptyErrorContext' type: object required: - type - code - message - doc_url - context title: AgentNameConflictErrorBody ConflictErrorBody: properties: type: type: string const: conflict_error title: Type code: type: string const: conflict title: Code message: type: string title: Message param: anyOf: - type: string - type: 'null' title: Param doc_url: type: string title: Doc Url context: $ref: '#/components/schemas/EmptyErrorContext' type: object required: - type - code - message - doc_url - context title: ConflictErrorBody ApiErrorEnvelope: properties: error: $ref: '#/components/schemas/ApiErrorBody' required: - error title: ApiErrorEnvelope type: object EmptyErrorContext: properties: {} additionalProperties: false type: object title: EmptyErrorContext ApiErrorBody: properties: type: $ref: '#/components/schemas/ErrorType' code: type: string title: Code message: type: string title: Message param: anyOf: - type: string - type: 'null' default: null title: Param doc_url: type: string title: Doc Url context: additionalProperties: true title: Context type: object required: - type - code - message - doc_url - context title: ApiErrorBody type: object ErrorType: enum: - invalid_request_error - authentication_error - permission_error - conflict_error - billing_error - rate_limit_error - dependency_error - api_error title: ErrorType type: string headers: RequestId: schema: type: string TrajectoryShouldRetry: schema: type: boolean RetryAfter: schema: type: string responses: ApiErrorResponse: description: >- Common API error. Possible codes: `authentication_required`, `permission_denied`, `validation_error`, `rate_limited`, `internal_error`, `service_unavailable`. headers: X-Request-ID: $ref: '#/components/headers/RequestId' Trajectory-Should-Retry: $ref: '#/components/headers/TrajectoryShouldRetry' Retry-After: $ref: '#/components/headers/RetryAfter' content: application/json: schema: $ref: '#/components/schemas/ApiErrorEnvelope' securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: Organization API key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.