Datavolumes

List datavolumes in permitted scopes

get

Get requested datavolumes.

Authorizations

AuthorizationstringRequired

Bearer authentication

Query parameters

requestTypestring · enumRequired

Which datavolumes to return in the GET datavolumes response. Originated - datavolumes that are originated in the permitted scopes of the caller. UsableInProject - datavolumes that can be used in a specific project; if you use this value, you must also provide the project ID in the "usableInProjectId" query param.

Example: OriginatedPossible values:

usableInProjectIdstringOptional

Only when using "UsableInProject" requestType; Filter results for only datavolumes that are shared with - or originated in - the project.

Example: 5

offsetinteger · int32Optional

The offset of the first item returned in the collection.

Example: 100

limitinteger · int32 · min: 1 · max: 500Optional

The maximum number of entries to return.

Default: 50

sortBystring · enumOptional

Sort results by a parameters.

Possible values:

sortOrderstring · enumOptional

Sort results in descending or ascending order.

Default: ascPossible values:

filterBystring[]Optional

Filter results by a parameter. Use the format field-name operator value. Operators are == Equals, != Not equals, <= Less than or equal, >= Greater than or equal, =@ contains, !@ Does not contains, =^ Starts with and =$ Ends with. Dates are in ISO 8601 timestamp format and available for operators ==, !=, <= and >=.

Example: ["name!=some-datavolume-name"]

searchstringOptional

Filter results by a free text search.

Example: test project

Responses

200

Executed successfully.

application/json

nextintegerOptionalExample: 1

400

Bad request.

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

500

unexpected error

application/json

503

unexpected error

application/json

get

/api/v1/datavolumes

GET /api/v1/datavolumes?requestType=Originated HTTP/1.1
Host: app.run.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "next": 1,
  "datavolumes": [
    {
      "id": "71f69d83-ba66-4822-adf5-55ce55efd210",
      "createdAt": "2026-03-22T09:02:13.128Z",
      "updatedAt": "2026-03-22T09:02:13.128Z",
      "createdBy": "[email protected]",
      "updatedBy": "[email protected]",
      "name": "datavolume-a",
      "description": "Results of experiment X",
      "originPvcName": "pvc-a",
      "projectId": "5",
      "shouldDeleteOriginalVolume": false,
      "useOriginalVolume": true,
      "projectName": "project-a",
      "departmentId": "department-a",
      "clusterId": "71f69d83-ba66-4822-adf5-55ce55efd210"
    },
    {
      "status": {
        "phase": "Ready",
        "phaseMessage": "Failed to copy pvc to project 'project-a'",
        "conditions": [
          {
            "type": "PvcsCreated",
            "status": "False",
            "message": "Failed to create pvc in namespace 'runai-proj1'",
            "reason": "ErrorCreatingPvc",
            "lastTransitionTime": "2022-01-01T03:49:52.531Z"
          }
        ],
        "datavolumePvcName": "datavolume-pvc-1",
        "datavolumePvName": "datavolume-pv-1"
      }
    }
  ]
}

Create a datavolume

post

Authorizations

AuthorizationstringRequired

Bearer authentication

Body

namestring · max: 63Required

The name of the new data volume.

Example: datavolume-aPattern: ^[a-z][-a-z0-9]{0,62}$

descriptionstring · max: 127Optional

A brief description of the data volume and its purpose.

Example: Results of experiment X

originPvcNamestringRequired

The name of the existing PVC that the new data volume is based on.

Example: pvc-a

projectIdstringRequired

The ID of the project whose namespace contains the origin PVC.

Example: 5

shouldDeleteOriginalVolumebooleanOptional

True is not supported. This parameter will be removed in a future release.

Default: falseExample: false

useOriginalVolumeboolean · nullableOptional

If true, the original storage volume will be used together with the data volume. Default true as long as "shouldDeleteOriginalVolume" is false.

Default: trueExample: true

Responses

201

Created

application/json

400

Bad request.

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

500

unexpected error

application/json

503

unexpected error

application/json

post

/api/v1/datavolumes

POST /api/v1/datavolumes HTTP/1.1
Host: app.run.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 163

{
  "name": "datavolume-a",
  "description": "Results of experiment X",
  "originPvcName": "pvc-a",
  "projectId": "5",
  "shouldDeleteOriginalVolume": false,
  "useOriginalVolume": true
}

{
  "id": "71f69d83-ba66-4822-adf5-55ce55efd210",
  "createdAt": "2026-03-22T09:02:13.128Z",
  "updatedAt": "2026-03-22T09:02:13.128Z",
  "createdBy": "[email protected]",
  "updatedBy": "[email protected]",
  "name": "datavolume-a",
  "description": "Results of experiment X",
  "originPvcName": "pvc-a",
  "projectId": "5",
  "shouldDeleteOriginalVolume": false,
  "useOriginalVolume": true,
  "projectName": "project-a",
  "departmentId": "department-a",
  "clusterId": "71f69d83-ba66-4822-adf5-55ce55efd210",
  "sharedScopes": [
    {
      "scopeType": "cluster",
      "scopeId": "a418ed33-9399-48c0-a890-122cadd13bfd",
      "scopeName": "project-a",
      "createdAt": "2026-03-22T09:02:13.128Z",
      "createdBy": "[email protected]"
    }
  ],
  "status": {
    "phase": "Ready",
    "phaseMessage": "Failed to copy pvc to project 'project-a'",
    "conditions": [
      {
        "type": "PvcsCreated",
        "status": "False",
        "message": "Failed to create pvc in namespace 'runai-proj1'",
        "reason": "ErrorCreatingPvc",
        "lastTransitionTime": "2022-01-01T03:49:52.531Z"
      }
    ],
    "datavolumePvcName": "datavolume-pvc-1",
    "datavolumePvName": "datavolume-pv-1"
  }
}

Get datavolume

get

Authorizations

AuthorizationstringRequired

Bearer authentication

Path parameters

datavolumeIdstring · uuidRequired

The id of the datavolume to retrieve

Example: 71f69d83-ba66-4822-adf5-55ce55efd210

Responses

200

Executed successfully.

application/json

idstring · uuidRequiredExample: 71f69d83-ba66-4822-adf5-55ce55efd210

createdAtstring · date-timeOptional

updatedAtstring · date-timeOptional

createdBystringOptionalExample: [email protected]

updatedBystringOptionalExample: [email protected]

namestring · max: 63Required

The name of the new data volume.

Example: datavolume-aPattern: ^[a-z][-a-z0-9]{0,62}$

descriptionstring · max: 127Optional

A brief description of the data volume and its purpose.

Example: Results of experiment X

originPvcNamestringRequired

The name of the existing PVC that the new data volume is based on.

Example: pvc-a

projectIdstringRequired

The ID of the project whose namespace contains the origin PVC.

Example: 5

shouldDeleteOriginalVolumebooleanOptional

True is not supported. This parameter will be removed in a future release.

Default: falseExample: false

useOriginalVolumeboolean · nullableOptional

If true, the original storage volume will be used together with the data volume. Default true as long as "shouldDeleteOriginalVolume" is false.

Default: trueExample: true

projectNamestringRequiredExample: project-a

departmentIdstringOptionalExample: department-a

clusterIdstring · uuidOptional

The id of the cluster.

Example: 71f69d83-ba66-4822-adf5-55ce55efd210

401

Unauthorized

application/json

403

Forbidden

application/json

404

The specified resource was not found

application/json

500

unexpected error

application/json

503

unexpected error

application/json

get

/api/v1/datavolumes/{datavolumeId}

GET /api/v1/datavolumes/{datavolumeId} HTTP/1.1
Host: app.run.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "71f69d83-ba66-4822-adf5-55ce55efd210",
  "createdAt": "2026-03-22T09:02:13.128Z",
  "updatedAt": "2026-03-22T09:02:13.128Z",
  "createdBy": "[email protected]",
  "updatedBy": "[email protected]",
  "name": "datavolume-a",
  "description": "Results of experiment X",
  "originPvcName": "pvc-a",
  "projectId": "5",
  "shouldDeleteOriginalVolume": false,
  "useOriginalVolume": true,
  "projectName": "project-a",
  "departmentId": "department-a",
  "clusterId": "71f69d83-ba66-4822-adf5-55ce55efd210",
  "sharedScopes": [
    {
      "scopeType": "cluster",
      "scopeId": "a418ed33-9399-48c0-a890-122cadd13bfd",
      "scopeName": "project-a",
      "createdAt": "2026-03-22T09:02:13.128Z",
      "createdBy": "[email protected]"
    }
  ],
  "status": {
    "phase": "Ready",
    "phaseMessage": "Failed to copy pvc to project 'project-a'",
    "conditions": [
      {
        "type": "PvcsCreated",
        "status": "False",
        "message": "Failed to create pvc in namespace 'runai-proj1'",
        "reason": "ErrorCreatingPvc",
        "lastTransitionTime": "2022-01-01T03:49:52.531Z"
      }
    ],
    "datavolumePvcName": "datavolume-pvc-1",
    "datavolumePvName": "datavolume-pv-1"
  }
}

Delete datavolume

delete

Authorizations

AuthorizationstringRequired

Bearer authentication

Path parameters

datavolumeIdstring · uuidRequired

The id of the datavolume to retrieve

Example: 71f69d83-ba66-4822-adf5-55ce55efd210

Responses

202

Accepted.

application/json

204

No Content.

401

Unauthorized

application/json

403

Forbidden

application/json

404

The specified resource was not found

application/json

500

unexpected error

application/json

503

unexpected error

application/json

delete

/api/v1/datavolumes/{datavolumeId}

DELETE /api/v1/datavolumes/{datavolumeId} HTTP/1.1
Host: app.run.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "code": 202,
  "message": "Request has been accepted."
}

Patch datavolume

patch

Authorizations

AuthorizationstringRequired

Bearer authentication

Path parameters

datavolumeIdstring · uuidRequired

The id of the datavolume to retrieve

Example: 71f69d83-ba66-4822-adf5-55ce55efd210

Body

descriptionstring · max: 127OptionalExample: Results of experiment X

Responses

200

Executed successfully.

application/json

idstring · uuidRequiredExample: 71f69d83-ba66-4822-adf5-55ce55efd210

createdAtstring · date-timeOptional

updatedAtstring · date-timeOptional

createdBystringOptionalExample: [email protected]

updatedBystringOptionalExample: [email protected]

namestring · max: 63Required

The name of the new data volume.

Example: datavolume-aPattern: ^[a-z][-a-z0-9]{0,62}$

descriptionstring · max: 127Optional

A brief description of the data volume and its purpose.

Example: Results of experiment X

originPvcNamestringRequired

The name of the existing PVC that the new data volume is based on.

Example: pvc-a

projectIdstringRequired

The ID of the project whose namespace contains the origin PVC.

Example: 5

shouldDeleteOriginalVolumebooleanOptional

True is not supported. This parameter will be removed in a future release.

Default: falseExample: false

useOriginalVolumeboolean · nullableOptional

If true, the original storage volume will be used together with the data volume. Default true as long as "shouldDeleteOriginalVolume" is false.

Default: trueExample: true

projectNamestringRequiredExample: project-a

departmentIdstringOptionalExample: department-a

clusterIdstring · uuidOptional

The id of the cluster.

Example: 71f69d83-ba66-4822-adf5-55ce55efd210

400

Bad request.

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

The specified resource was not found

application/json

500

unexpected error

application/json

503

unexpected error

application/json

patch

/api/v1/datavolumes/{datavolumeId}

PATCH /api/v1/datavolumes/{datavolumeId} HTTP/1.1
Host: app.run.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 41

{
  "description": "Results of experiment X"
}

{
  "id": "71f69d83-ba66-4822-adf5-55ce55efd210",
  "createdAt": "2026-03-22T09:02:13.128Z",
  "updatedAt": "2026-03-22T09:02:13.128Z",
  "createdBy": "[email protected]",
  "updatedBy": "[email protected]",
  "name": "datavolume-a",
  "description": "Results of experiment X",
  "originPvcName": "pvc-a",
  "projectId": "5",
  "shouldDeleteOriginalVolume": false,
  "useOriginalVolume": true,
  "projectName": "project-a",
  "departmentId": "department-a",
  "clusterId": "71f69d83-ba66-4822-adf5-55ce55efd210",
  "status": {
    "phase": "Ready",
    "phaseMessage": "Failed to copy pvc to project 'project-a'",
    "conditions": [
      {
        "type": "PvcsCreated",
        "status": "False",
        "message": "Failed to create pvc in namespace 'runai-proj1'",
        "reason": "ErrorCreatingPvc",
        "lastTransitionTime": "2022-01-01T03:49:52.531Z"
      }
    ],
    "datavolumePvcName": "datavolume-pvc-1",
    "datavolumePvName": "datavolume-pv-1"
  }
}

Data volumes name availability.

get

Checks if a specified data volume name is available under the given scope (e.g., project or department). Returns a 204 No Content response if the name is available, or 409 Conflict if the name is already in use.

Authorizations

AuthorizationstringRequired

Bearer authentication

Query parameters

dataNamestring · min: 1Required

the name of the datavolume

clusterIdstring · uuidRequired

The id of the cluster

Example: d73a738f-fab3-430a-8fa3-5241493d7128

Responses

204

The name is available to use

401

Unauthorized

application/json

403

Forbidden

application/json

409

The specified resource already exists

application/json

503

unexpected error

application/json

get

/api/v1/datavolumes/name-availability

GET /api/v1/datavolumes/name-availability?dataName=text&clusterId=d73a738f-fab3-430a-8fa3-5241493d7128 HTTP/1.1
Host: app.run.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Count data volumes.

get

Retrieve the number of data volumes.

Authorizations

AuthorizationstringRequired

Bearer authentication

Query parameters

requestTypestring · enumRequired

Example: OriginatedPossible values:

usableInProjectIdstringOptional

Only when using "UsableInProject" requestType; Filter results for only datavolumes that are shared with - or originated in - the project.

Example: 5

filterBystring[]Optional

Example: ["name!=some-datavolume-name"]

searchstringOptional

Filter results by a free text search.

Example: test project

Responses

200

Executed successfully.

application/json

countinteger · int64RequiredExample: 1

400

Bad request.

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

500

unexpected error

application/json

503

unexpected error

application/json

get

/api/v1/datavolumes/count

GET /api/v1/datavolumes/count?requestType=Originated HTTP/1.1
Host: app.run.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "count": 1
}

Get the datavolume's shared scopes

get

Authorizations

AuthorizationstringRequired

Bearer authentication

Path parameters

datavolumeIdstring · uuidRequired

The id of the datavolume to retrieve

Example: 71f69d83-ba66-4822-adf5-55ce55efd210

Responses

200

Executed successfully.

application/json

scopeTypestring · enumRequiredPossible values:

scopeIdstringRequiredExample: a418ed33-9399-48c0-a890-122cadd13bfd

scopeNamestringRequired

The name of the scope

Example: project-a

createdAtstring · date-timeOptional

createdBystringOptionalExample: [email protected]

401

Unauthorized

application/json

403

Forbidden

application/json

404

The specified resource was not found

application/json

500

unexpected error

application/json

503

unexpected error

application/json

get

/api/v1/datavolumes/{datavolumeId}/sharedScopes

GET /api/v1/datavolumes/{datavolumeId}/sharedScopes HTTP/1.1
Host: app.run.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "scopeType": "cluster",
    "scopeId": "a418ed33-9399-48c0-a890-122cadd13bfd",
    "scopeName": "project-a",
    "createdAt": "2026-03-22T09:02:13.128Z",
    "createdBy": "[email protected]"
  }
]

Patch the datavolume's shared scopes

patch

Authorizations

AuthorizationstringRequired

Bearer authentication

Path parameters

datavolumeIdstring · uuidRequired

The id of the datavolume to retrieve

Example: 71f69d83-ba66-4822-adf5-55ce55efd210

Body

Responses

200

Executed successfully.

application/json

scopeTypestring · enumRequiredPossible values:

scopeIdstringRequiredExample: a418ed33-9399-48c0-a890-122cadd13bfd

scopeNamestringRequired

The name of the scope

Example: project-a

createdAtstring · date-timeOptional

createdBystringOptionalExample: [email protected]

400

Bad request.

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

The specified resource was not found

application/json

500

unexpected error

application/json

503

unexpected error

application/json

patch

/api/v1/datavolumes/{datavolumeId}/sharedScopes

PATCH /api/v1/datavolumes/{datavolumeId}/sharedScopes HTTP/1.1
Host: app.run.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 166

{
  "add": [
    {
      "scopeType": "cluster",
      "scopeId": "a418ed33-9399-48c0-a890-122cadd13bfd"
    }
  ],
  "remove": [
    {
      "scopeType": "cluster",
      "scopeId": "a418ed33-9399-48c0-a890-122cadd13bfd"
    }
  ]
}

[
  {
    "scopeType": "cluster",
    "scopeId": "a418ed33-9399-48c0-a890-122cadd13bfd",
    "scopeName": "project-a",
    "createdAt": "2026-03-22T09:02:13.128Z",
    "createdBy": "[email protected]"
  }
]

PreviousAuditLogs NextEvents

Last updated 1 hour ago

Good morning

hashtagList datavolumes in permitted scopes

hashtagCreate a datavolume

hashtagGet datavolume

hashtagDelete datavolume

hashtagPatch datavolume

hashtagData volumes name availability.

hashtagCount data volumes.

hashtagGet the datavolume's shared scopes

hashtagPatch the datavolume's shared scopes

List datavolumes in permitted scopes

Create a datavolume

Get datavolume

Delete datavolume

Patch datavolume

Data volumes name availability.

Count data volumes.

Get the datavolume's shared scopes

Patch the datavolume's shared scopes