Users

Show My User

get

Authorizations

JWTAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/json

idintegerRequired

usernamestringRequired

emailstring · emailRequired

displayNameany ofOptional

stringOptional

or

nullOptional

descriptionany ofOptional

stringOptional

or

nullOptional

urlstringRequired

get

/v1/users/me

HTTPcURLJavaScriptPython

GET /v1/users/me HTTP/1.1
Host: api.icosa.gallery
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

OK

{
  "id": 1,
  "username": "text",
  "email": "[email protected]",
  "displayName": "text",
  "description": "text",
  "url": "text"
}

Update My User

patch

Authorizations

JWTAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

urlany ofOptional

stringOptional

or

nullOptional

displaynameany ofOptional

stringOptional

or

nullOptional

descriptionany ofOptional

stringOptional

or

nullOptional

Responses

200

OK

application/json

idintegerRequired

usernamestringRequired

emailstring · emailRequired

displayNameany ofOptional

stringOptional

or

nullOptional

descriptionany ofOptional

stringOptional

or

nullOptional

urlstringRequired

patch

/v1/users/me

HTTPcURLJavaScriptPython

PATCH /v1/users/me HTTP/1.1
Host: api.icosa.gallery
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 56

{
  "url": "text",
  "displayname": "text",
  "description": "text"
}

200

OK

{
  "id": 1,
  "username": "text",
  "email": "[email protected]",
  "displayName": "text",
  "description": "text",
  "url": "text"
}

List My Assets

get

Authorizations

JWTAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

categoryany ofOptionalExample: ANIMALS

string · enumOptionalPossible values:

or

nullOptional

curatedany ofOptional

booleanOptional

or

nullOptional

formatany ofOptional

Filter by format

or

nullOptional

keywordsany ofOptional

stringOptional

or

nullOptional

nameany ofOptional

stringOptional

or

nullOptional

descriptionany ofOptional

stringOptional

or

nullOptional

tagstring[]Optional

triangleCountMinany ofOptional

integerOptional

or

nullOptional

triangleCountMaxany ofOptional

integerOptional

or

nullOptional

maxComplexityany ofOptional

string · enumOptionalPossible values:

or

nullOptional

zipArchiveUrlany ofOptional

stringOptional

or

nullOptional

inCollectionany ofOptional

booleanOptional

or

nullOptional

visibilityany ofOptional

stringOptional

or

nullOptional

orderByany ofOptional

string · enumOptionalPossible values:

or

nullOptional

pageTokenany ofOptional

stringOptional

or

nullOptional

pageSizeany ofOptional

stringOptional

or

nullOptional

Responses

200

OK

application/json

totalSizeintegerRequired

nextPageTokenany ofOptional

stringOptional

or

nullOptional

get

/v1/users/me/assets

HTTPcURLJavaScriptPython

GET /v1/users/me/assets HTTP/1.1
Host: api.icosa.gallery
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

OK

{
  "assets": [
    {
      "authorId": "text",
      "authorName": "text",
      "name": "text",
      "description": "text",
      "createTime": "2026-03-12T08:29:59.796Z",
      "updateTime": "2026-03-12T08:29:59.796Z",
      "url": "text",
      "assetId": "text",
      "displayName": "text",
      "visibility": "text",
      "tags": [
        "text"
      ],
      "isCurated": true,
      "thumbnail": {
        "relativePath": "text",
        "contentType": "text",
        "url": "text"
      },
      "triangleCount": 1,
      "license": "text",
      "licenseVersion": "text",
      "presentationParams": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "formats": [
        {
          "root": {
            "relativePath": "text",
            "contentType": "text",
            "url": "text"
          },
          "resources": [
            {
              "relativePath": "text",
              "contentType": "text",
              "url": "text"
            }
          ],
          "formatComplexity": {
            "triangleCount": 1,
            "lodHint": 1
          },
          "formatType": "text",
          "zip_archive_url": "text",
          "isPreferredForDownload": false
        }
      ],
      "state": "text"
    }
  ],
  "totalSize": 1,
  "nextPageToken": "text"
}

Create A New Asset

post

Authorizations

JWTAuthAsync

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

multipart/form-data

triangleCountany ofOptional

integerOptional

or

nullOptional

remixIdsany ofOptional

string[]Optional

or

nullOptional

formatOverrideany ofOptional

string[]Optional

or

nullOptional

filesany ofOptional

string · binary[]Optional

or

nullOptional

Responses

201

Created

application/json

post

/v1/users/me/assets

HTTPcURLJavaScriptPython

POST /v1/users/me/assets HTTP/1.1
Host: api.icosa.gallery
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 84

{
  "triangleCount": 1,
  "remixIds": [
    "text"
  ],
  "formatOverride": [
    "text"
  ],
  "files": [
    "binary"
  ]
}

201

Created

{
  "publishUrl": "text",
  "assetId": "text"
}

Show An Asset

get

Authorizations

JWTAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

asset_urlstringRequired

Responses

200

OK

application/json

authorIdany ofOptional

stringOptional

or

nullOptional

authorNamestringRequired

namestringRequired

descriptionany ofRequired

stringOptional

or

nullOptional

createTimestring · date-timeRequired

updateTimeany ofRequired

string · date-timeOptional

or

nullOptional

urlany ofRequired

stringOptional

or

nullOptional

assetIdstringRequired

displayNameany ofRequired

stringOptional

or

nullOptional

visibilitystringRequired

tagsstring[]OptionalDefault: []

isCuratedany ofOptional

booleanOptional

or

nullOptional

thumbnailany ofRequired

or

nullOptional

triangleCountintegerRequired

licensestringRequired

licenseVersionany ofRequired

stringOptional

or

nullOptional

presentationParamsany ofOptional

or

nullOptional

statestringRequired

get

/v1/users/me/assets/{asset_url}

HTTPcURLJavaScriptPython

GET /v1/users/me/assets/{asset_url} HTTP/1.1
Host: api.icosa.gallery
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

OK

{
  "authorId": "text",
  "authorName": "text",
  "name": "text",
  "description": "text",
  "createTime": "2026-03-12T08:29:59.796Z",
  "updateTime": "2026-03-12T08:29:59.796Z",
  "url": "text",
  "assetId": "text",
  "displayName": "text",
  "visibility": "text",
  "tags": [
    "text"
  ],
  "isCurated": true,
  "thumbnail": {
    "relativePath": "text",
    "contentType": "text",
    "url": "text"
  },
  "triangleCount": 1,
  "license": "text",
  "licenseVersion": "text",
  "presentationParams": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "formats": [
    {
      "root": {
        "relativePath": "text",
        "contentType": "text",
        "url": "text"
      },
      "resources": [
        {
          "relativePath": "text",
          "contentType": "text",
          "url": "text"
        }
      ],
      "formatComplexity": {
        "triangleCount": 1,
        "lodHint": 1
      },
      "formatType": "text",
      "zip_archive_url": "text",
      "isPreferredForDownload": false
    }
  ],
  "state": "text"
}

Delete An Asset

delete

Authorizations

JWTAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

asset_urlstringRequired

Responses

204

No Content

400

Bad Request

application/json

delete

/v1/users/me/assets/{asset_url}

HTTPcURLJavaScriptPython

DELETE /v1/users/me/assets/{asset_url} HTTP/1.1
Host: api.icosa.gallery
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Set An Image For An Asset

post

Authorizations

JWTAuthAsync

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

asset_urlstringRequired

Body

multipart/form-data

imagestring · binaryRequired

Responses

201

Created

application/json

400

Bad Request

application/json

post

/v1/users/me/assets/{asset_url}/set_thumbnail

HTTPcURLJavaScriptPython

POST /v1/users/me/assets/{asset_url}/set_thumbnail HTTP/1.1
Host: api.icosa.gallery
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 18

{
  "image": "binary"
}

{
  "url": "text"
}

List My Likedassets

get

Authorizations

JWTAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

categoryany ofOptionalExample: ANIMALS

string · enumOptionalPossible values:

or

nullOptional

curatedany ofOptional

booleanOptional

or

nullOptional

formatany ofOptional

Filter by format

or

nullOptional

keywordsany ofOptional

stringOptional

or

nullOptional

nameany ofOptional

stringOptional

or

nullOptional

descriptionany ofOptional

stringOptional

or

nullOptional

tagstring[]Optional

triangleCountMinany ofOptional

integerOptional

or

nullOptional

triangleCountMaxany ofOptional

integerOptional

or

nullOptional

maxComplexityany ofOptional

string · enumOptionalPossible values:

or

nullOptional

zipArchiveUrlany ofOptional

stringOptional

or

nullOptional

inCollectionany ofOptional

booleanOptional

or

nullOptional

authorNameany ofOptional

stringOptional

or

nullOptional

authorIdany ofOptional

stringOptional

or

nullOptional

licenseany ofOptional

string · enumOptionalPossible values:

or

nullOptional

orderByany ofOptional

string · enumOptionalPossible values:

or

nullOptional

pageTokenany ofOptional

stringOptional

or

nullOptional

pageSizeany ofOptional

stringOptional

or

nullOptional

Responses

200

OK

application/json

totalSizeintegerRequired

nextPageTokenany ofOptional

stringOptional

or

nullOptional

get

/v1/users/me/likedassets

HTTPcURLJavaScriptPython

GET /v1/users/me/likedassets HTTP/1.1
Host: api.icosa.gallery
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

OK

{
  "assets": [
    {
      "authorId": "text",
      "authorName": "text",
      "name": "text",
      "description": "text",
      "createTime": "2026-03-12T08:29:59.796Z",
      "updateTime": "2026-03-12T08:29:59.796Z",
      "url": "text",
      "assetId": "text",
      "displayName": "text",
      "visibility": "text",
      "tags": [
        "text"
      ],
      "isCurated": true,
      "thumbnail": {
        "relativePath": "text",
        "contentType": "text",
        "url": "text"
      },
      "triangleCount": 1,
      "license": "text",
      "licenseVersion": "text",
      "presentationParams": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "formats": [
        {
          "root": {
            "relativePath": "text",
            "contentType": "text",
            "url": "text"
          },
          "resources": [
            {
              "relativePath": "text",
              "contentType": "text",
              "url": "text"
            }
          ],
          "formatComplexity": {
            "triangleCount": 1,
            "lodHint": 1
          },
          "formatType": "text",
          "zip_archive_url": "text",
          "isPreferredForDownload": false
        }
      ]
    }
  ],
  "totalSize": 1,
  "nextPageToken": "text"
}

Get My Collections

get

Authorizations

JWTAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

pageTokenany ofOptional

stringOptional

or

nullOptional

pageSizeany ofOptional

stringOptional

or

nullOptional

Responses

200

OK

application/json

totalSizeintegerRequired

nextPageTokenany ofOptional

stringOptional

or

nullOptional

get

/v1/users/me/collections

HTTPcURLJavaScriptPython

GET /v1/users/me/collections HTTP/1.1
Host: api.icosa.gallery
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

OK

{
  "collections": [
    {
      "collectionId": "text",
      "name": "text",
      "description": "text",
      "url": "text",
      "createTime": "2026-03-12T08:29:59.796Z",
      "updateTime": "2026-03-12T08:29:59.796Z",
      "visibility": "text",
      "imageUrl": "text",
      "assets": [
        {
          "authorId": "text",
          "authorName": "text",
          "name": "text",
          "description": "text",
          "createTime": "2026-03-12T08:29:59.796Z",
          "updateTime": "2026-03-12T08:29:59.796Z",
          "url": "text",
          "assetId": "text",
          "displayName": "text",
          "visibility": "text",
          "tags": [
            "text"
          ],
          "isCurated": true,
          "thumbnail": {
            "relativePath": "text",
            "contentType": "text",
            "url": "text"
          },
          "triangleCount": 1,
          "license": "text",
          "licenseVersion": "text",
          "presentationParams": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "formats": [
            {
              "root": {
                "relativePath": "text",
                "contentType": "text",
                "url": "text"
              },
              "resources": [
                {
                  "relativePath": "text",
                  "contentType": "text",
                  "url": "text"
                }
              ],
              "formatComplexity": {
                "triangleCount": 1,
                "lodHint": 1
              },
              "formatType": "text",
              "zip_archive_url": "text",
              "isPreferredForDownload": false
            }
          ]
        }
      ]
    }
  ],
  "totalSize": 1,
  "nextPageToken": "text"
}

Create A Collection

post

Authorizations

JWTAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

namestringRequired

descriptionany ofOptional

stringOptional

or

nullOptional

visibilityany ofOptional

string · enumOptionalPossible values:

or

nullOptional

asset_urlany ofOptional

string[]Optional

or

nullOptional

Responses

201

Created

application/json

400

Bad Request

application/json

post

/v1/users/me/collections

HTTPcURLJavaScriptPython

POST /v1/users/me/collections HTTP/1.1
Host: api.icosa.gallery
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 80

{
  "name": "text",
  "description": "text",
  "visibility": "PRIVATE",
  "asset_url": [
    "text"
  ]
}

{
  "collection": {
    "collectionId": "text",
    "name": "text",
    "description": "text",
    "url": "text",
    "createTime": "2026-03-12T08:29:59.796Z",
    "updateTime": "2026-03-12T08:29:59.796Z",
    "visibility": "text",
    "imageUrl": "text",
    "assets": [
      {
        "authorId": "text",
        "authorName": "text",
        "name": "text",
        "description": "text",
        "createTime": "2026-03-12T08:29:59.796Z",
        "updateTime": "2026-03-12T08:29:59.796Z",
        "url": "text",
        "assetId": "text",
        "displayName": "text",
        "visibility": "text",
        "tags": [
          "text"
        ],
        "isCurated": true,
        "thumbnail": {
          "relativePath": "text",
          "contentType": "text",
          "url": "text"
        },
        "triangleCount": 1,
        "license": "text",
        "licenseVersion": "text",
        "presentationParams": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        },
        "formats": [
          {
            "root": {
              "relativePath": "text",
              "contentType": "text",
              "url": "text"
            },
            "resources": [
              {
                "relativePath": "text",
                "contentType": "text",
                "url": "text"
              }
            ],
            "formatComplexity": {
              "triangleCount": 1,
              "lodHint": 1
            },
            "formatType": "text",
            "zip_archive_url": "text",
            "isPreferredForDownload": false
          }
        ]
      }
    ]
  },
  "rejectedAssetUrls": [
    "text"
  ]
}

Show A Collection

get

Authorizations

JWTAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

asset_collection_urlstringRequired

Responses

200

OK

application/json

collectionIdstringRequired

namestringRequired

descriptionany ofOptional

stringOptional

or

nullOptional

urlstringRequired

createTimestring · date-timeRequired

updateTimeany ofRequired

string · date-timeOptional

or

nullOptional

visibilitystringRequired

imageUrlany ofOptional

stringOptional

or

nullOptional

assetsany ofOptional

or

nullOptional

get

/v1/users/me/collections/{asset_collection_url}

HTTPcURLJavaScriptPython

GET /v1/users/me/collections/{asset_collection_url} HTTP/1.1
Host: api.icosa.gallery
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

OK

{
  "collectionId": "text",
  "name": "text",
  "description": "text",
  "url": "text",
  "createTime": "2026-03-12T08:29:59.796Z",
  "updateTime": "2026-03-12T08:29:59.796Z",
  "visibility": "text",
  "imageUrl": "text",
  "assets": [
    {
      "authorId": "text",
      "authorName": "text",
      "name": "text",
      "description": "text",
      "createTime": "2026-03-12T08:29:59.796Z",
      "updateTime": "2026-03-12T08:29:59.796Z",
      "url": "text",
      "assetId": "text",
      "displayName": "text",
      "visibility": "text",
      "tags": [
        "text"
      ],
      "isCurated": true,
      "thumbnail": {
        "relativePath": "text",
        "contentType": "text",
        "url": "text"
      },
      "triangleCount": 1,
      "license": "text",
      "licenseVersion": "text",
      "presentationParams": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "formats": [
        {
          "root": {
            "relativePath": "text",
            "contentType": "text",
            "url": "text"
          },
          "resources": [
            {
              "relativePath": "text",
              "contentType": "text",
              "url": "text"
            }
          ],
          "formatComplexity": {
            "triangleCount": 1,
            "lodHint": 1
          },
          "formatType": "text",
          "zip_archive_url": "text",
          "isPreferredForDownload": false
        }
      ]
    }
  ]
}

Delete A Collection

delete

Authorizations

JWTAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

asset_collection_urlstringRequired

Responses

204

No Content

delete

/v1/users/me/collections/{asset_collection_url}

HTTPcURLJavaScriptPython

DELETE /v1/users/me/collections/{asset_collection_url} HTTP/1.1
Host: api.icosa.gallery
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

204

No Content

No content

Update A Collection

patch

Authorizations

JWTAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

asset_collection_urlstringRequired

Body

application/json

nameany ofOptional

stringOptional

or

nullOptional

descriptionany ofOptional

stringOptional

or

nullOptional

visibilityany ofOptional

string · enumOptionalPossible values:

or

nullOptional

asset_urlany ofOptional

string[]Optional

or

nullOptional

Responses

200

OK

application/json

rejectedAssetUrlsany ofOptional

string[]Optional

or

nullOptional

400

Bad Request

application/json

patch

/v1/users/me/collections/{asset_collection_url}

HTTPcURLJavaScriptPython

PATCH /v1/users/me/collections/{asset_collection_url} HTTP/1.1
Host: api.icosa.gallery
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 80

{
  "name": "text",
  "description": "text",
  "visibility": "PRIVATE",
  "asset_url": [
    "text"
  ]
}

{
  "collection": {
    "collectionId": "text",
    "name": "text",
    "description": "text",
    "url": "text",
    "createTime": "2026-03-12T08:29:59.796Z",
    "updateTime": "2026-03-12T08:29:59.796Z",
    "visibility": "text",
    "imageUrl": "text",
    "assets": [
      {
        "authorId": "text",
        "authorName": "text",
        "name": "text",
        "description": "text",
        "createTime": "2026-03-12T08:29:59.796Z",
        "updateTime": "2026-03-12T08:29:59.796Z",
        "url": "text",
        "assetId": "text",
        "displayName": "text",
        "visibility": "text",
        "tags": [
          "text"
        ],
        "isCurated": true,
        "thumbnail": {
          "relativePath": "text",
          "contentType": "text",
          "url": "text"
        },
        "triangleCount": 1,
        "license": "text",
        "licenseVersion": "text",
        "presentationParams": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        },
        "formats": [
          {
            "root": {
              "relativePath": "text",
              "contentType": "text",
              "url": "text"
            },
            "resources": [
              {
                "relativePath": "text",
                "contentType": "text",
                "url": "text"
              }
            ],
            "formatComplexity": {
              "triangleCount": 1,
              "lodHint": 1
            },
            "formatType": "text",
            "zip_archive_url": "text",
            "isPreferredForDownload": false
          }
        ]
      }
    ]
  },
  "rejectedAssetUrls": [
    "text"
  ]
}

Overwrite Assets For A Collection

put

Authorizations

JWTAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

asset_collection_urlstringRequired

Body

application/json

asset_urlany ofOptional

string[]Optional

or

nullOptional

Responses

200

OK

application/json

rejectedAssetUrlsany ofOptional

string[]Optional

or

nullOptional

400

Bad Request

application/json

put

/v1/users/me/collections/{asset_collection_url}/set_assets

HTTPcURLJavaScriptPython

PUT /v1/users/me/collections/{asset_collection_url}/set_assets HTTP/1.1
Host: api.icosa.gallery
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 22

{
  "asset_url": [
    "text"
  ]
}

{
  "collection": {
    "collectionId": "text",
    "name": "text",
    "description": "text",
    "url": "text",
    "createTime": "2026-03-12T08:29:59.796Z",
    "updateTime": "2026-03-12T08:29:59.796Z",
    "visibility": "text",
    "imageUrl": "text",
    "assets": [
      {
        "authorId": "text",
        "authorName": "text",
        "name": "text",
        "description": "text",
        "createTime": "2026-03-12T08:29:59.796Z",
        "updateTime": "2026-03-12T08:29:59.796Z",
        "url": "text",
        "assetId": "text",
        "displayName": "text",
        "visibility": "text",
        "tags": [
          "text"
        ],
        "isCurated": true,
        "thumbnail": {
          "relativePath": "text",
          "contentType": "text",
          "url": "text"
        },
        "triangleCount": 1,
        "license": "text",
        "licenseVersion": "text",
        "presentationParams": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        },
        "formats": [
          {
            "root": {
              "relativePath": "text",
              "contentType": "text",
              "url": "text"
            },
            "resources": [
              {
                "relativePath": "text",
                "contentType": "text",
                "url": "text"
              }
            ],
            "formatComplexity": {
              "triangleCount": 1,
              "lodHint": 1
            },
            "formatType": "text",
            "zip_archive_url": "text",
            "isPreferredForDownload": false
          }
        ]
      }
    ]
  },
  "rejectedAssetUrls": [
    "text"
  ]
}

Set An Image For A Collection

post

Authorizations

JWTAuthAsync

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

asset_collection_urlstringRequired

Body

multipart/form-data

imagestring · binaryRequired

Responses

201

Created

application/json

400

Bad Request

application/json

post

/v1/users/me/collections/{asset_collection_url}/set_thumbnail

HTTPcURLJavaScriptPython

POST /v1/users/me/collections/{asset_collection_url}/set_thumbnail HTTP/1.1
Host: api.icosa.gallery
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 18

{
  "image": "binary"
}

{
  "url": "text"
}