> ## Documentation Index > Fetch the complete documentation index at: https://developers.liara.ir/llms.txt > Use this file to discover all available pages before exploring further. # List background operations > Lists the database's background operations from the last month, such as backups, password resets, disk resizes, restores and backup file imports, newest first. Team permission: `view`, `operate` or `manage`. ## OpenAPI ````yaml /spec/dbaas.yaml get /v2/databases/{databaseID}/operations-status openapi: 3.0.1 info: title: Databases version: 1.0.0 description: > Create managed databases, connect to them, change their plans and settings, back them up and restore them, and read their metrics and events. Supported types: `mysql`, `mariadb`, `postgres`, `mongodb`, `redis`, `mssql`, `elasticsearch`, `rabbitmq` and `clickhouse`. Databases are created in one of your private networks (see Networks in Apps & Deployments). ## Connecting `GET /v1/databases/{databaseID}` returns the connection details: - **From apps in the same network:** `hostname` and `internalPort`. - **Over the public network** (if `publicNetwork` is on): `network.node.host` and `port`. - **Credentials:** `username` and `root_password`. ## Team permissions With `teamID`, each endpoint needs one of the database permissions it lists (`view`, `operate` or `manage`). A permission from your role or a resource permission on that database both count. servers: - url: https://api.liara.ir security: - bearerAuth: [] tags: - name: Databases description: Create, list, inspect and delete databases. - name: Configuration description: Plans, scaling, settings, public network, password and control panel. - name: Backups description: Back up databases, download backups and import backup files. - name: Metrics & Events description: >- Resource usage, lifecycle events and the progress of background operations. paths: /v2/databases/{databaseID}/operations-status: get: tags: - Metrics & Events summary: List background operations description: >- Lists the database's background operations from the last month, such as backups, password resets, disk resizes, restores and backup file imports, newest first. Team permission: `view`, `operate` or `manage`. operationId: listDatabaseOperations parameters: - $ref: '#/components/parameters/TeamID' - $ref: '#/components/parameters/DatabaseID' - name: type in: query required: false schema: $ref: '#/components/schemas/OperationType' - name: status in: query required: false schema: type: string enum: - queued - in_progress - succeeded - failed - name: interval in: query required: false description: Only with `type=DatabaseDump`. Filter backups by interval. schema: type: string enum: - manual - hourly - daily - weekly - monthly - name: page in: query required: false schema: type: integer minimum: 1 default: 1 - name: count in: query required: false schema: type: integer minimum: 1 maximum: 100 default: 10 responses: '200': description: Operations. content: application/json: schema: type: object properties: totalOperations: type: integer operations: type: array items: type: object properties: _id: type: string name: $ref: '#/components/schemas/OperationType' createdAt: type: string format: date-time description: When the operation was queued. lockedAt: type: string format: date-time description: When it started. Missing while it's queued. succeededAt: type: string format: date-time failedAt: type: string format: date-time data: type: object properties: interval: type: string description: For backups, the backup interval. example: totalOperations: 1 operations: - _id: '000000000000000000000310' name: DatabaseDump createdAt: '2026-01-01T08:00:00.000Z' lockedAt: '2026-01-01T08:00:05.000Z' succeededAt: '2026-01-01T08:01:00.000Z' data: interval: manual '400': $ref: '#/components/responses/ValidationOrTeamIDError' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/TeamForbidden' '404': $ref: '#/components/responses/DatabaseNotFound' components: parameters: TeamID: name: teamID in: query required: false description: >- Run the request in the context of a team you belong to, instead of your personal account. schema: $ref: '#/components/schemas/ObjectID' example: '000000000000000000000002' DatabaseID: name: databaseID in: path required: true description: The database's `_id`. schema: $ref: '#/components/schemas/ObjectID' example: '000000000000000000000300' schemas: OperationType: type: string description: >- `DatabaseDump`: backup. `DatabaseResetPassword`: password reset. `VolumeResize`: disk resize. `DatabaseRestore`: restore. `MssqlPutBakFile` / `ClickhousePutBakFile`: backup file import. enum: - DatabaseDump - DatabaseResetPassword - VolumeResize - DatabaseRestore - MssqlPutBakFile - ClickhousePutBakFile ObjectID: type: string pattern: ^[0-9a-fA-F]{24}$ description: 24-character hexadecimal ID. Error: type: object description: Standard error body. properties: statusCode: type: integer error: type: string description: HTTP status text. message: type: string description: What went wrong. data: type: object nullable: true description: >- Extra details. When present, `code` is a stable, machine-readable error code. properties: code: type: string AuthError: type: object description: Error body returned when the API token is rejected. properties: error: type: string responses: ValidationOrTeamIDError: description: >- The body or a parameter is invalid (`message` says which), or `teamID` isn't a valid ID. content: application/json: schema: $ref: '#/components/schemas/Error' examples: validation: summary: Invalid parameter value: statusCode: 400 error: Bad Request message: Invalid id invalidTeamID: summary: Invalid team ID value: statusCode: 400 error: Bad Request message: Invalid team ID. data: null Unauthorized: description: The API token is missing, invalid or expired. content: application/json: schema: $ref: '#/components/schemas/AuthError' example: error: Unauthorized. TeamForbidden: description: >- With `teamID`: you aren't a member of the team (`team_not_found`), or you don't have the required permission on this database (`no_permission`). content: application/json: schema: $ref: '#/components/schemas/Error' examples: teamNotFound: summary: Not a team member value: statusCode: 403 error: Forbidden message: Team not found data: code: team_not_found noPermission: summary: Missing permission value: statusCode: 403 error: Forbidden message: You do not have permission to access this resource. data: code: no_permission DatabaseNotFound: description: The database doesn't exist. content: application/json: schema: $ref: '#/components/schemas/Error' example: statusCode: 404 error: Not Found message: Database not found. data: null securitySchemes: bearerAuth: type: http scheme: bearer description: 'Send your API token as `Authorization: Bearer `.' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.