> ## Documentation Index > Fetch the complete documentation index at: https://openrouter.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Suspend an intern > Stops the intern runtime while keeping its disk and configuration for a later provision call. The API key selects the caller, workspace and visible interns. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required. ## OpenAPI ````yaml /openapi/openapi.yaml post /interns/{internId}/suspend openapi: 3.1.0 info: contact: email: support@openrouter.ai name: OpenRouter Support url: https://openrouter.ai/docs description: OpenAI-compatible API with additional OpenRouter features license: name: MIT url: https://opensource.org/licenses/MIT title: OpenRouter API version: 1.0.0 servers: - description: Production server url: https://openrouter.ai/api/v1 x-speakeasy-server-id: production security: - apiKey: [] tags: - description: API key management endpoints name: API Keys - description: Analytics and usage endpoints name: Analytics - description: Anthropic Messages endpoints name: Anthropic Messages - description: BYOK endpoints name: BYOK - description: Benchmarks endpoints name: Benchmarks - description: Chat completion endpoints name: Chat - description: Task classification market-share endpoints name: Classifications - description: Containers endpoints name: Containers - description: Credit management endpoints name: Credits - description: >- Public OpenRouter usage datasets. Data returned by these endpoints is licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/): reuse and republish it, including commercially, with attribution to OpenRouter. name: Datasets - description: Text embedding endpoints name: Embeddings - description: Endpoint information name: Endpoints - description: Files endpoints name: Files - description: Generation history endpoints name: Generations - description: Guardrails endpoints name: Guardrails - description: Images endpoints name: Images - description: >- Create, inspect, update, provision, suspend and delete OpenRouter interns through an API key, and talk to them: the chat route streams OpenAI-compatible completions from one intern, pausing as an `openrouter.provide_input` tool call when the intern needs your permission or an answer. Available to interns programme members; other callers receive 404. See https://openrouter.ai/docs/guides/ori/intern-chat. name: Interns - description: Model information endpoints name: Models - description: OAuth authentication endpoints name: OAuth - description: Observability endpoints name: Observability - description: Organization endpoints name: Organization - description: Presets endpoints name: Presets - description: Provider information endpoints name: Providers - description: Rerank endpoints name: Rerank - description: OpenAI-compatible Responses API endpoints name: Responses - description: >- Management endpoints for SCIM group-to-workspace mappings, authenticated with a management key. These are not the SCIM 2.0 connector endpoints for your identity provider. In your identity provider, enter the SCIM endpoint URL shown when you enable provisioning under Settings > Members > SCIM Mappings. See https://openrouter.ai/docs/guides/features/scim-mappings#set-up-provisioning. name: SCIM - description: Speech-to-text endpoints name: STT x-displayName: Transcriptions - description: Text-to-speech endpoints name: TTS x-displayName: Speech - description: >- Store host-bound secrets for a workspace or for one intern. Scope is selected by the API key. Responses return metadata only, never secret values. See https://openrouter.ai/docs/guides/ori/vault. name: Vault - description: Video Generation endpoints name: Video Generation - description: Workspaces endpoints name: Workspaces externalDocs: description: OpenRouter Documentation url: https://openrouter.ai/docs paths: /interns/{internId}/suspend: post: tags: - Interns summary: Suspend an intern description: >- Stops the intern runtime while keeping its disk and configuration for a later provision call. The API key selects the caller, workspace and visible interns. There is no default workspace fallback. Requests on regional hostnames such as `eu.openrouter.ai` are refused. [API key](/docs/api-reference/authentication) required. operationId: suspendIntern parameters: - description: ID of an intern visible to the authenticated API key. in: path name: internId required: true schema: description: ID of an intern visible to the authenticated API key. example: 7c9e6679-7425-40de-944b-e07fc1f90ae7 minLength: 1 type: string responses: '200': content: application/json: example: suspended: true schema: $ref: '#/components/schemas/SuspendInternResponse' description: Intern suspended. '401': content: application/json: example: error: code: 401 message: Invalid or missing API key schema: $ref: '#/components/schemas/InternLifecycleError' description: Missing, unknown or provisioning API key. '403': content: application/json: example: error: code: 403 message: Forbidden schema: $ref: '#/components/schemas/InternLifecycleError' description: >- The key owner no longer has access, or the request used a regional hostname. '404': content: application/json: example: error: code: not_found message: Intern not found schema: $ref: '#/components/schemas/InternLifecycleError' description: >- The caller is outside the Intern API programme, the intern is hidden, or lifecycle writes are disabled. '408': content: application/json: example: error: code: 408 message: Request timed out schema: $ref: '#/components/schemas/InternLifecycleError' description: The request exceeded its route deadline. '409': content: application/json: example: error: code: intern_busy message: The intern is not in a state that allows this operation schema: $ref: '#/components/schemas/InternLifecycleError' description: The intern is not in a state that allows this operation. '500': content: application/json: example: error: code: internal_error message: The request could not be completed schema: $ref: '#/components/schemas/InternLifecycleError' description: The request could not be completed. '502': content: application/json: example: error: code: upstream_unavailable message: The intern service could not be reached, retry the request schema: $ref: '#/components/schemas/InternLifecycleError' description: The intern service could not accept the operation. security: - apiKey: [] components: schemas: SuspendInternResponse: additionalProperties: false properties: suspended: const: true type: boolean required: - suspended type: object InternLifecycleError: additionalProperties: false description: Intern lifecycle request failure. example: error: code: not_found message: Intern not found properties: error: additionalProperties: false properties: code: anyOf: - type: string - type: integer message: type: string required: - code - message type: object required: - error type: object securitySchemes: apiKey: description: API key as bearer token in Authorization header scheme: bearer type: http ````