> ## Documentation Index > Fetch the complete documentation index at: https://docs.agentsfleet.net/llms.txt > Use this file to discover all available pages before exploring further. # Renew an authoring lease ## OpenAPI ````yaml https://raw.githubusercontent.com/agentsfleet/agentsfleet/main/public/openapi.json post /v1/runners/me/authoring-leases/{lease_id}/renew openapi: 3.1.0 info: title: agentsfleet Control Plane API description: API for managing workspaces, fleets, triggers, and runs. contact: name: agentsfleet url: https://agentsfleet.net license: name: MIT identifier: MIT version: 1.0.0 servers: - url: https://api.agentsfleet.net description: Production security: [] paths: /v1/runners/me/authoring-leases/{lease_id}/renew: post: tags: - Runners summary: Renew an authoring lease operationId: runner_authoring_renew parameters: - name: lease_id in: path description: '`UUIDv7` of the lease.' required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/Renew' required: true responses: '200': description: Durable acknowledgement content: application/json: schema: $ref: '#/components/schemas/Renewed' '400': description: Invalid request content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '401': description: Unauthorized content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '402': description: Wallet coverage insufficient content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '403': description: Forbidden content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '404': description: Lease unavailable content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '409': description: Lost lease or replay conflict content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '413': description: Envelope too large content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '429': description: Too many requests content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '500': description: Internal failure content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '503': description: Dependency unavailable content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' security: - RunnerBearerAuth: [] components: schemas: Renew: type: object description: Own-lease renewal with cumulative observations. required: - fence - deletion_generation - usage properties: deletion_generation: type: string description: Decimal private deletion generation. fence: type: string description: Decimal current fence. usage: $ref: '#/components/schemas/Meter' description: Monotone cumulative observations, verified by the daemon. additionalProperties: false Renewed: type: object description: Live extension and remaining bounded output allowance. required: - expires_at - stop_requested - remaining_output_tokens - model_access_expires_at properties: expires_at: type: integer format: int64 description: Extended Unix-millisecond deadline. model_access_expires_at: type: integer format: int64 description: The original capability remains bound to the renewed lease. remaining_output_tokens: type: integer format: int64 description: Output tokens still available across this attempt. minimum: 0 stop_requested: type: boolean description: Whether the runner must stop private work. ProblemBody: type: object description: The body every refusal carries, under `application/problem+json`. required: - docs_uri - title - detail - error_code - request_id properties: action_id: type: - string - 'null' description: 'On that 409 only: the action the gate held.' current_state: type: - string - 'null' description: 'On a 409 only: the state that forbade the transition.' detail: type: string description: One sentence on what was refused and why. docs_uri: type: string description: Where the error code is documented. error_code: type: string description: The registry code, stable across releases. etag: type: - string - 'null' description: >- On a 412 only: the resource's current entity tag, to refetch and retry. gate_id: type: - string - 'null' description: 'On an answered approval gate''s 409 only: the gate that was answered.' outcome: type: - string - 'null' description: 'On that 409 only: the answer that stands.' request_id: type: string description: The request this refusal answers, for support. resolved_at: type: - integer - 'null' format: int64 description: 'On that 409 only: when the standing answer was given.' resolved_by: type: - string - 'null' description: 'On that 409 only: who gave it.' title: type: string description: A short name for the refusal, safe to show a person. user_message: type: - string - 'null' description: A curated sentence for end users, where the code has one. Meter: type: object description: >- Bounded cumulative observations supplied on renewal and terminal reports. required: - knowledge - calls - runtime_ms properties: calls: type: integer format: int32 description: Number of physical dispatches observed by the runner. minimum: 0 input_tokens: type: - integer - 'null' format: int64 description: Known cumulative input tokens, when available. minimum: 0 knowledge: $ref: '#/components/schemas/Knowledge' description: Unknown is never converted to known using a local estimate. output_tokens: type: - integer - 'null' format: int64 description: Known cumulative output tokens, when available. minimum: 0 provider_cost_nanos: type: - string - 'null' description: Canonical decimal nanos, checked against daemon receipts. runtime_ms: type: integer format: int64 description: Runtime from the attempt's monotonic timer. minimum: 0 additionalProperties: false Knowledge: type: string description: Whether all reported provider usage is known. enum: - known - unknown securitySchemes: RunnerBearerAuth: type: http scheme: bearer bearerFormat: agt_r description: The opaque agt_r token minted when the runner enrols (POST /v1/runners) ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.