> ## Documentation Index > Fetch the complete documentation index at: https://docs.tokenfactory.nebius.com/llms.txt > Use this file to discover all available pages before exploring further. # List operations > Returns a list of running and completed operations ## OpenAPI ````yaml https://eu-north.nebius.computer/static/api.yaml get /operations openapi: 3.0.0 info: title: Contree API description: > Contree is a container management system combining virtual machine isolation with container operational efficiency. Designed for security-sensitive workloads requiring hardware-enforced boundaries while maintaining container workflow compatibility. version: 1.0.0 servers: - url: '{baseUrl}/v1' description: | Nebius IAM-fronted endpoint (use `IAMBearerAuth` + `IAMProjectHeader`). Override `baseUrl` to point at a different deployment. variables: baseUrl: default: https://api.tokenfactory.nebius.com/sandboxes description: | Base URL of the contree service. Defaults to the public Nebius IAM-fronted endpoint; set to your self-hosted contree origin (e.g. `https://contree.example.com`) when running elsewhere. security: - IAMBearerAuth: [] IAMProjectHeader: [] tags: - name: images description: Operations related to container images - name: files description: Operations related to file uploads - name: instances description: Operations related to container instances - name: inspect description: Operations related to inspecting container images - name: operations description: Operations related to long-running operations - name: auth description: Authentication and token introspection paths: /operations: get: tags: - operations summary: List operations description: Returns a list of running and completed operations operationId: listOperations parameters: - name: limit in: query required: false schema: type: integer minimum: 1 maximum: 1000 default: 100 description: | Maximum number of operations to return. Must be between 1 and 1000. Default is 100. Invalid values raise 400 error. - name: offset in: query required: false schema: type: integer minimum: 0 default: 0 description: > Number of operations to skip before starting to collect the result set. Default is 0. Invalid values raise 400 error. - name: status in: query required: false schema: type: string enum: - PENDING - EXECUTING - SUCCESS - FAILED - CANCELLED - ASSIGNED description: Filter operations by their state - name: kind in: query required: false schema: type: string enum: - image_import - instance description: Filter operations by their kind - $ref: '#/components/parameters/SinceParameter' - $ref: '#/components/parameters/UntilParameter' responses: '200': description: OK content: application/json: schema: type: array items: $ref: '#/components/schemas/OperationSummary' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' components: parameters: SinceParameter: name: since in: query required: false schema: type: string example: 1w description: > **Show only results created after the given date/time or interval.** Accepts a Unix timestamp or interval string. Interval format: `600s`/`15m`/`2h`/`3d`/`1w` means 600 seconds, 15 minutes, 2 hours, 3 day, or 1 week ago respectively). For example: * `2025-01-01T12:00:00+00:00` means January 1st, 2025 at 12:00 UTC * `600s` means 600 seconds ago * `15m` means 15 minutes ago Invalid values raise 400 error. UntilParameter: name: until in: query required: false description: > **Show only results created before the given date/time or interval.** Accepts a Unix timestamp or interval string. Interval format: `600s`/`15m`/`2h`/`3d`/`1w` means 600 seconds, 15 minutes, 2 hours, 3 day, or 1 week ago respectively). For example: * `2025-01-01T12:00:00+00:00` means January 1st, 2025 at 12:00 UTC * `600s` means 600 seconds ago * `15m` means 15 minutes ago Invalid values raise 400 error. schema: type: string example: 1h schemas: OperationSummary: type: object properties: uuid: $ref: '#/components/schemas/UUIDSchema' kind: type: string description: Type of the operation enum: - image_import - instance status: type: string enum: - PENDING - ASSIGNED - EXECUTING - SUCCESS - FAILED - CANCELLED description: Current state of the instance operation example: success error: type: string nullable: true description: Error message if the operation failed example: Container image not found created_at: type: string description: ISO 8601 formatted timestamp when the operation was created example: '2024-01-01T12:00:00+00:00' duration: type: number nullable: true description: Operation duration in seconds image_size: type: integer nullable: true description: > Bytes written for the resulting image/layer(s). `null` when not measured (e.g. disposable instance, non-SUCCESS operations). consumed_cpu: type: number nullable: true description: > CPU seconds (user_cpu_time + system_cpu_time) reported by the in-VM init. `null` when not measured. consumed_memory: type: integer nullable: true description: > Peak memory (max_rss) reported by the in-VM init; units preserved as reported by getrusage. `null` when not measured. image_uuid: nullable: true allOf: - $ref: '#/components/schemas/UUIDSchema' description: | UUID of the source image this operation was run on. Set for INSTANCE operations, `null` for IMAGE_IMPORT. result_image_uuid: nullable: true allOf: - $ref: '#/components/schemas/UUIDSchema' description: | UUID of the image produced by this operation. Only set for completed (SUCCESS) operations, `null` otherwise. UUIDSchema: type: string format: uuid description: A UUID string example: 12345678-9abc-baba-deda-0123456789ab Error: type: object required: - error properties: error: oneOf: - type: string - type: object - type: array items: type: object description: Error message or structured validation errors example: Some error occurred, this is an example of error message status: type: integer description: HTTP status code example: 500 traceback: type: array items: type: string responses: BadRequest: description: Bad Request - Invalid request parameters content: application/json: schema: $ref: '#/components/schemas/Error' Unauthorized: description: | Unauthorized - Invalid or missing authentication credentials. Either the `Authorization` bearer token is missing or invalid, or the `Project` header is missing. content: application/json: schema: $ref: '#/components/schemas/Error' Forbidden: description: Forbidden - Token does not have sufficient permissions content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: IAMBearerAuth: type: http scheme: bearer bearerFormat: IAM description: | IAM bearer token issued by the Nebius IAM service. Sent as `Authorization: Bearer `. Must be combined with the `Project` header (see `IAMProjectHeader`). This is the recommended authentication scheme for new clients. IAMProjectHeader: type: apiKey in: header name: Project description: | Nebius project ID associated with the IAM token. Required together with `IAMBearerAuth`. Identifies the project context the request is scoped to. ````