Ctrlk
Contact support
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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
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-01-01T00:00:00.000Z",
      "updatedAt": "2026-01-01T00:00:00.000Z",
      "createdBy": "user@run.ai",
      "updatedBy": "user@run.ai",
      "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
idstring · uuidRequiredExample: 71f69d83-ba66-4822-adf5-55ce55efd210
createdAtstring · date-timeOptional
updatedAtstring · date-timeOptional
createdBystringOptionalExample: user@run.ai
updatedBystringOptionalExample: user@run.ai
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
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-01-01T00:00:00.000Z",
  "updatedAt": "2026-01-01T00:00:00.000Z",
  "createdBy": "user@run.ai",
  "updatedBy": "user@run.ai",
  "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-01-01T00:00:00.000Z",
      "createdBy": "user@run.ai"
    }
  ],
  "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: user@run.ai
updatedBystringOptionalExample: user@run.ai
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
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-01-01T00:00:00.000Z",
  "updatedAt": "2026-01-01T00:00:00.000Z",
  "createdBy": "user@run.ai",
  "updatedBy": "user@run.ai",
  "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-01-01T00:00:00.000Z",
      "createdBy": "user@run.ai"
    }
  ],
  "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
codeinteger · min: 100 · max: 599Required
messagestringRequired
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: user@run.ai
updatedBystringOptionalExample: user@run.ai
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
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-01-01T00:00:00.000Z",
  "updatedAt": "2026-01-01T00:00:00.000Z",
  "createdBy": "user@run.ai",
  "updatedBy": "user@run.ai",
  "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

No content
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

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
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
countinteger · int64RequiredExample: 1
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: user@run.ai
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-01-01T00:00:00.000Z",
    "createdBy": "user@run.ai"
  }
]

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: user@run.ai
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-01-01T00:00:00.000Z",
    "createdBy": "user@run.ai"
  }
]
PreviousAudit LogsNextEvents

Last updated