Asset Admin | Subrite

Asset Admin

Endpoints for Asset Admin

ReferenceUpdated October 13, 2026View as Markdown

GET/api/v1/asset-admin/folders

Authentication: Bearer token (JWT)

Responses

2 status codes

Responses 200

Status200 401application/json

Schema ExampleFolderListResponseDto

5 top-level fieldsSelect an object to expand

foldersarray of AssetFolderResponseDtoRequired5 fields
folders
- idnumberRequired when parent is presentField path: folders[].id
- namestringRequired when parent is presentField path: folders[].name
- slugstringRequired when parent is presentField path: folders[].slug
- fileCountnumberRequired when parent is presentField path: folders[].fileCount
  Number of ready files in this folder.
- createdAtstring (date-time)Required when parent is present

10 documented fields · Scroll to see moreShow full heightShow compact view

Schema ExampleFolderListResponseDto

200 · application/json

{
  "folders": [
    {}
  ],
  "totalFileCount": 0,
  "totalSizeBytes": 0,
  "cdnDomain": "string",
  "cdnBasePath": "string"
}

Example · 9 linesShow full heightShow compact view

Responses 401

unauthorized

This response has no body.

Example requestcurl

curl

curl https://api.subrite.no/api/v1/asset-admin/folders \
  --header 'Authorization: Bearer <token>'

Try it

Create a folder#

POST/api/v1/asset-admin/folders

Authentication: Bearer token (JWT)

Request body

Required bodyapplication/json

Schema ExampleCreateAssetFolderDto

1 top-level field

namestringRequired
Folder display name.maxLength: 64

1 documented field · Scroll to see moreShow full heightShow compact view

Schema ExampleCreateAssetFolderDto

DELETE/api/v1/asset-admin/folders/{id}

Authentication: Bearer token (JWT)

Parameters

Path parameters1

idnumberRequired

Responses

4 status codes

Responses 200

Status200 401 404 409application/json

Schema ExampleDeleteResultDto

2 top-level fields

PATCH/api/v1/asset-admin/folders/{id}

Authentication: Bearer token (JWT)

Parameters

Path parameters1

idnumberRequired

Request body

Required bodyapplication/json

Schema ExampleUpdateAssetFolderDto

1 top-level field

namestringRequired

GET/api/v1/asset-admin/assets

Authentication: Bearer token (JWT)

Parameters

Query parameters7

pagenumberOptional
Default: 1minimum: 1
takenumberOptional
Default: 24minimum: 1maximum: 50
folderIdnumberOptional
Folder to list. Omit for "All files"; pass 0 or "root" for root-level files.minimum: 0
kindsarray of AssetKind

Upload one or more files#

POST/api/v1/asset-admin/assets

Authentication: Bearer token (JWT)

Request body

Required bodymultipart/form-data

SchemaUploadAssetsDto

1 top-level field

folderIdnumberOptional
Destination folder id. Omit (or leave empty) to upload to the root.minimum: 0

1 documented field · Scroll to see moreShow full heightShow compact view

Responses

4 status codes

Responses 200

GET/api/v1/asset-admin/assets/{id}

Authentication: Bearer token (JWT)

Parameters

Path parameters1

idnumberRequired

Responses

3 status codes

Responses 200

Status200 401 404application/json

Schema ExampleAssetResponseDto

12 top-level fields

DELETE/api/v1/asset-admin/assets/{id}

Authentication: Bearer token (JWT)

Parameters

Path parameters1

idnumberRequired

Responses

3 status codes

Responses 200

Status200 401 404application/json

Schema ExampleDeleteResultDto

Same fields as Delete a folder and every file it contains (hard delete) (200).

PATCH/api/v1/asset-admin/assets/{id}

Authentication: Bearer token (JWT)

Parameters

Path parameters1

idnumberRequired

Request body

Required bodyapplication/json

Schema ExampleUpdateAssetDto

3 top-level fields

titlestringOptional

GET/api/v1/asset-admin/assets/{id}/download

Authentication: Bearer token (JWT)

Parameters

Path parameters1

idnumberRequired

Responses

3 status codes

Responses 200

The file bytes, sent as an attachment.

This response has no body.

Responses

5 status codes

Responses 200

Status200 201 400 401 409application/json

Schema ExampleAssetFolderResponseDto

5 top-level fields

idnumberRequired
namestringRequired
slugstringRequired
fileCountnumberRequired
Number of ready files in this folder.
createdAtstring (date-time)Required

5 documented fields · Scroll to see moreShow full heightShow compact view

Schema ExampleAssetFolderResponseDto

200 · application/json

{
  "id": 0,
  "name": "string",
  "slug": "string",
  "fileCount": 0,
  "createdAt": "2019-08-24T14:15:22Z"
}

Example · 7 linesShow full heightShow compact view

Responses 201

Status200 201 400 401 409application/json

SchemaAssetFolderResponseDto

Same fields as Create a folder (200).

Responses 400

Status200 201 400 401 409application/json

assetFolderNameInvalid

Schema ExampleErrorResponse

3 top-level fieldsSelect an object to expand

messageCodestringRequired
Allowed values: "assetFolderNameInvalid"
messagestring
errorsarray of FieldErrorRequired

Responses 401

unauthorized

This response has no body.

Responses 409

Status200 201 400 401 409application/json

assetFolderNameConflict, assetFolderLimitReached, assetFolderDeleteInProgress

Schema ExampleErrorResponse

3 top-level fieldsSelect an object to expand

messageCodestringRequired
Allowed values: "assetFolderNameConflict", "assetFolderLimitReached", "assetFolderDeleteInProgress"
messagestring

Example requestcurl

curl

curl https://api.subrite.no/api/v1/asset-admin/folders \
  --request POST \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "string"
}'

Responses 404

Status200 401 404 409application/json

assetFolderNotFound

Schema ExampleErrorResponse

3 top-level fieldsSelect an object to expand

messageCodestringRequired
Allowed values: "assetFolderNotFound"
messagestring
errorsarray of FieldErrorRequired7 fields
errors
- fieldstringRequired when parent is presentField path: errors[].field
- fieldValuestringRequired when parent is presentField path: errors[].fieldValue
- identifierstringRequired when parent is presentField path: errors[].identifier
- identifierValuestringRequired when parent is presentField path: errors[].identifierValue
- messageCodestringRequired when parent is presentField path: errors[].messageCode
- messagestringField path: errors[].message
- errorTypestringRequired when parent is present

10 documented fields · Scroll to see moreShow full heightShow compact view

Schema ExampleErrorResponse

404 · application/json

{
  "messageCode": "assetFolderNotFound",
  "message": "string",
  "errors": [
    {}
  ]
}

Example · 7 linesShow full heightShow compact view

Responses 409

Status200 401 404 409application/json

assetFolderRenameInProgress

Schema ExampleErrorResponse

3 top-level fieldsSelect an object to expand

messageCodestringRequired
Allowed values: "assetFolderRenameInProgress"
messagestring
errorsarray of FieldErrorRequired7 fields
errors
- fieldstringRequired when parent is presentField path: errors[].field
- fieldValuestringRequired when parent is presentField path: errors[].fieldValue
- identifierstringRequired when parent is presentField path: errors[].identifier
- identifierValuestringRequired when parent is presentField path: errors[].identifierValue
- messageCodestringRequired when parent is presentField path: errors[].messageCode
- messagestringField path: errors[].message
- errorTypestringRequired when parent is present

10 documented fields · Scroll to see moreShow full heightShow compact view

Schema ExampleErrorResponse

409 · application/json

{
  "messageCode": "assetFolderRenameInProgress",
  "message": "string",
  "errors": [
    {}
  ]
}

Example · 7 linesShow full heightShow compact view

Responses

5 status codes

Responses 200

Status200 400 401 404 409application/json

Schema ExampleAssetFolderResponseDto

Same fields as Create a folder (200).

Schema ExampleAssetFolderResponseDto

200 · application/json

{
  "id": 0,
  "name": "string",
  "slug": "string",
  "fileCount": 0,
  "createdAt": "2019-08-24T14:15:22Z"
}

Example · 7 linesShow full heightShow compact view

Responses 400

Status200 400 401 404 409application/json

assetFolderNameInvalid

Schema ExampleErrorResponse

Same fields as Create a folder (400).

Schema ExampleErrorResponse

400 · application/json

{
  "messageCode": "assetFolderNameInvalid",
  "message": "string",
  "errors": [
    {}
  ]
}

Responses 401

unauthorized

This response has no body.

Responses 404

Status200 400 401 404 409application/json

assetFolderNotFound

Schema ExampleErrorResponse

Same fields as Delete a folder and every file it contains (hard delete) (404).

Schema ExampleErrorResponse

404 · application/json

{
  "messageCode": "assetFolderNotFound",
  "message": "string",
  "errors": [
    {}
  ]
}

Responses 409

Status200 400 401 404 409application/json

assetFolderNameConflict, assetFolderDeleteInProgress, assetFolderRenameInProgress

Schema ExampleErrorResponse

3 top-level fieldsSelect an object to expand

messageCodestringRequired
Allowed values: "assetFolderNameConflict", "assetFolderDeleteInProgress", "assetFolderRenameInProgress"
messagestring

Example requestcurl

curl

curl 'https://api.subrite.no/api/v1/asset-admin/folders/{id}' \
  --request PATCH \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "string"
}'

Responses

3 status codes

Responses 200

Status200 400 401application/json

Schema ExampleAssetResponseDtoPaginated

2 top-level fieldsSelect an object to expand

itemsarray of AssetResponseDtoRequired12 fields
items
- idnumberRequired when parent is presentField path: items[].id
- folderIdnumberRequired when parent is presentField path: items[].folderId
  Can be null
- titlestringRequired when parent is presentField path: items[].title
  Human display name (shown in the UI).
- namestringRequired when parent is presentField path: items[].name
  URL-safe file name — the last segment of the public path.
- urlstringRequired when parent is presentField path: items[].url
  Public CDN URL, derived from tenant + folder slug + name.
- kindstringRequired when parent is presentField path: items[].kind
  Allowed values: "image", "svg", "pdf", "video", "audio", "font", "doc"
- mimeTypestringRequired when parent is presentField path: items[].mimeType
- sizeBytesnumberRequired when parent is presentField path: items[].sizeBytes
  File size in bytes.
- widthnumberRequired when parent is presentField path: items[].width
  Can be null
- heightnumberRequired when parent is presentField path: items[].height
  Can be null
- altTextstringRequired when parent is presentField path: items[].altText
  Can be null
- createdAtstring (date-time)Required when parent is presentField path: items[].createdAt
metaPageMetaRequired6 fields
meta
- pagenumberRequiredField path: meta.page
- takenumberRequiredField path: meta.take
- countnumberRequiredField path: meta.count
- pageCountnumberRequiredField path: meta.pageCount
- hasPreviousPagebooleanRequiredField path: meta.hasPreviousPage
- hasNextPagebooleanRequiredField path: meta.hasNextPage

20 documented fields · Scroll to see moreShow full heightShow compact view

Schema ExampleAssetResponseDtoPaginated

200 · application/json

{
  "items": [
    {}
  ],
  "meta": {
    "page": 0,
    "take": 0,
    "count": 0,
    "pageCount": 0,
    "hasPreviousPage": true,
    "hasNextPage": true
  }
}

Example · 13 linesShow full heightShow compact view

Responses 400

Status200 400 401application/json

badRequest

Schema ExampleErrorResponse

3 top-level fieldsSelect an object to expand

messageCodestringRequired
Allowed values: "badRequest"
messagestring
errorsarray of FieldErrorRequired7 fields

Responses 401

unauthorized

This response has no body.

application/json

Schema ExampleUploadResultDto

1 top-level fieldSelect an object to expand

resultsarray of UploadResultItemDtoRequired4 fields
results
- fileNamestringRequired when parent is presentField path: results[].fileName
  Original filename from the request.
- successbooleanRequired when parent is presentField path: results[].success
- assetAssetResponseDtoRequired when parent is presentCan be nullField path: results[].asset12 fields
  results[].asset
  - idnumberRequired when parent is presentField path: results[].asset.id
  - folderIdnumberRequired when parent is presentField path: results[].asset.folderId
    Can be null
  - titlestringRequired when parent is presentField path: results[].asset.title
    Human display name (shown in the UI).
  - namestringRequired when parent is presentField path: results[].asset.name
    URL-safe file name — the last segment of the public path.
  - urlstringRequired when parent is presentField path: results[].asset.url
    Public CDN URL, derived from tenant + folder slug + name.
- errorstringRequired when parent is presentField path: results[].error
  Can be nullError message when success is false.

17 documented fields · Scroll to see moreShow full heightShow compact view

Schema ExampleUploadResultDto

200 · application/json

{
  "results": [
    {}
  ]
}

Example · 5 linesShow full heightShow compact view

Responses 404

Status200 401 404 409application/json

assetFolderNotFound

Schema ExampleErrorResponse

Same fields as Delete a folder and every file it contains (hard delete) (404).

Schema ExampleErrorResponse

404 · application/json

{
  "messageCode": "assetFolderNotFound",
  "message": "string",
  "errors": [
    {}
  ]
}

Example · 7 linesShow full heightShow compact view

Responses 409

Status200 401 404 409application/json

assetFolderRenameInProgress

Schema ExampleErrorResponse

Same fields as Delete a folder and every file it contains (hard delete) (409).

Schema ExampleErrorResponse

409 · application/json

{
  "messageCode": "assetFolderRenameInProgress",
  "message": "string",
  "errors": [
    {}
  ]
}

Example · 7 linesShow full heightShow compact view

Schema ExampleAssetResponseDto

200 · application/json

{
  "id": 0,
  "folderId": 0,
  "title": "string",
  "name": "string",
  "url": "string",
  "kind": "image",
  "mimeType": "string",
  "sizeBytes": 0,
  "width": 0,
  "height": 0,
  "altText": "string",
  "createdAt": "2019-08-24T14:15:22Z"
}

Example · 14 linesShow full heightShow compact view

Responses 404

Status200 401 404application/json

assetFileNotFound

Schema ExampleErrorResponse

3 top-level fieldsSelect an object to expand

messageCodestringRequired
Allowed values: "assetFileNotFound"
messagestring
errorsarray of FieldErrorRequired7 fields
errors
- fieldstringRequired when parent is presentField path: errors[].field
- fieldValuestringRequired when parent is presentField path: errors[].fieldValue
- identifierstringRequired when parent is presentField path: errors[].identifier
- identifierValuestringRequired when parent is presentField path: errors[].identifierValue
- messageCodestringRequired when parent is presentField path: errors[].messageCode
- messagestringField path: errors[].message
- errorTypestringRequired when parent is present

10 documented fields · Scroll to see moreShow full heightShow compact view

Schema ExampleErrorResponse

404 · application/json

{
  "messageCode": "assetFileNotFound",
  "message": "string",
  "errors": [
    {}
  ]
}

Example · 7 linesShow full heightShow compact view

Responses 404

Status200 401 404application/json

assetFileNotFound

Schema ExampleErrorResponse

Same fields as Get a single asset (preview modal data) (404).

Schema ExampleErrorResponse

404 · application/json

{
  "messageCode": "assetFileNotFound",
  "message": "string",
  "errors": [
    {}
  ]
}

Example · 7 linesShow full heightShow compact view

Responses

4 status codes

Responses 200

Status200 401 404 409application/json

Schema ExampleAssetResponseDto

Same fields as Get a single asset (preview modal data) (200).

Schema ExampleAssetResponseDto

200 · application/json

{
  "id": 0,
  "folderId": 0,
  "title": "string",
  "name": "string",
  "url": "string",
  "kind": "image",
  "mimeType": "string",
  "sizeBytes": 0,
  "width": 0,
  "height": 0,
  "altText": "string",
  "createdAt": "2019-08-24T14:15:22Z"
}

Example · 14 linesShow full heightShow compact view

Responses 401

unauthorized

This response has no body.

Responses 404

Status200 401 404 409application/json

assetFileNotFound, assetFolderNotFound

Schema ExampleErrorResponse

3 top-level fieldsSelect an object to expand

messageCodestringRequired
Allowed values: "assetFileNotFound", "assetFolderNotFound"
messagestring

Responses 409

Status200 401 404 409application/json

assetFileNameConflict, assetFolderRenameInProgress

Schema ExampleErrorResponse

3 top-level fieldsSelect an object to expand

messageCodestringRequired
Allowed values: "assetFileNameConflict", "assetFolderRenameInProgress"
messagestring

Example requestcurl

curl

curl 'https://api.subrite.no/api/v1/asset-admin/assets/{id}' \
  --request PATCH \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "title": "string",
  "folderId": 0,
  "altText": "string"
}'

Responses 404

Status200 401 404application/json

assetFileNotFound

Schema ExampleErrorResponse

Same fields as Get a single asset (preview modal data) (404).

Schema ExampleErrorResponse

404 · application/json

{
  "messageCode": "assetFileNotFound",
  "message": "string",
  "errors": [
    {}
  ]
}

Example · 7 linesShow full heightShow compact view

Schema ExampleErrorResponse

400 · application/json

{
  "messageCode": "assetFolderNameInvalid",
  "message": "string",
  "errors": [
    {}
  ]
}

Example · 7 linesShow full heightShow compact view

Schema ExampleErrorResponse

409 · application/json

{
  "messageCode": "assetFolderNameConflict",
  "message": "string",
  "errors": [
    {}
  ]
}

Example · 7 linesShow full heightShow compact view

Schema ExampleErrorResponse

409 · application/json

{
  "messageCode": "assetFolderNameConflict",
  "message": "string",
  "errors": [
    {}
  ]
}

Example · 7 linesShow full heightShow compact view

errors

Schema ExampleErrorResponse

409 · application/json

{
  "messageCode": "assetFileNameConflict",
  "message": "string",
  "errors": [
    {}
  ]
}

Example · 7 linesShow full heightShow compact view

List folders with counts and tenant-wide usage totals#

Responses

Responses 200

Responses 401

Create a folder#

Request body

Delete a folder and every file it contains (hard delete)#

Parameters

Responses

Responses 200

Rename a folder (re-slugs it and moves child objects; their URLs change)#

Parameters

Request body

List/search/sort assets (paginated, spans the whole tenant set)#

Parameters

Upload one or more files#

Request body

Responses

Responses 200

Get a single asset (preview modal data)#

Parameters

Responses

Responses 200

Delete an asset (hard delete — the R2 object and the row are both removed)#

Parameters

Responses

Responses 200

Rename (rewrites the object key/URL), move, or edit title/altText of an asset#

Parameters

Request body

Download an asset — streams the R2 object with Content-Disposition: attachment#

Parameters

Responses

Responses 200

List folders with counts and tenant-wide usage totals#

Responses

Responses 200

Responses 401

Create a folder#

Request body

Delete a folder and every file it contains (hard delete)#

Parameters

Responses

Responses 200

Rename a folder (re-slugs it and moves child objects; their URLs change)#

Parameters

Request body

List/search/sort assets (paginated, spans the whole tenant set)#

Parameters

Upload one or more files#

Request body

Responses

Responses 200

Get a single asset (preview modal data)#

Parameters

Responses

Responses 200

Delete an asset (hard delete — the R2 object and the row are both removed)#

Parameters

Responses

Responses 200

Rename (rewrites the object key/URL), move, or edit title/altText of an asset#

Parameters

Request body

Download an asset — streams the R2 object with Content-Disposition: attachment#

Parameters

Responses

Responses 200

Responses

Responses 200

Responses 201

Responses 400

Responses 401

Responses 409

Responses 401

Responses 404

Responses 409

Responses

Responses 200

Responses 400