Assets

Get resources by moderation kind and status

GET
/v1_1/{cloud_name}/resources/{resource_type}/moderations/{moderation_kind}/{moderation_status}

Retrieves resources matching specific moderation kind and status.

Authorization

AuthorizationBasic <token>

Basic authentication using Cloudinary API Key and API Secret.

In: header

Path Parameters

cloud_name*string

The cloud name of your product environment.

resource_type*string

The type of resource (image, video, or raw).

Value in

  • "image"
  • "video"
  • "raw"
moderation_kind*string

The type of moderation to filter by.

Value in

  • "manual"
  • "webpurify"
  • "aws_rek"
  • "aws_rek_video"
  • "perception_point"
  • "google_video_moderation"
  • "duplicate"
moderation_status*string

The moderation status to filter by.

Value in

  • "approved"
  • "rejected"
  • "pending"
  • "queued"
  • "aborted"

Query Parameters

fields?|array<>

Additional fields to include in the response. The fields public_id and asset_id are always included.

next_cursor?string

Cursor for pagination.

max_results?integer

Maximum number of results to return (1-500).

Range1 <= value <= 500
direction?string

The sort direction for the results. Default is "desc".

Value in

  • "asc"
  • "desc"

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1_1/my_cloud/resources/image/moderations/manual/approved"
{  "resources": [    {      "asset_id": "string",      "public_id": "string",      "asset_folder": "string",      "display_name": "string",      "folder": "string",      "filename": "string",      "format": "string",      "version": 0,      "resource_type": "string",      "type": "upload",      "created_at": "2019-08-24T14:15:22Z",      "uploaded_at": "2019-08-24T14:15:22Z",      "bytes": 0,      "backup_bytes": 0,      "width": 0,      "height": 0,      "aspect_ratio": 0,      "pixels": 0,      "tags": [        "string"      ],      "context": {        "custom": {          "property1": "string",          "property2": "string"        },        "property1": {          "property1": "string",          "property2": "string"        },        "property2": {          "property1": "string",          "property2": "string"        }      },      "metadata": {},      "moderation_kind": "string",      "moderation_status": "string",      "moderation": [        {          "kind": "string",          "status": "string",          "updated_at": "2019-08-24T14:15:22Z"        }      ],      "backup": true,      "url": "http://example.com",      "secure_url": "http://example.com",      "status": "string",      "access_control": [        {          "access_type": "token",          "key": "string",          "start": "string",          "end": "string"        }      ],      "etag": "string",      "animated": true,      "duration": 0,      "resource_subtype": "string",      "substatus": "string",      "related_assets": [        {}      ],      "last_updated": {        "access_control_updated_at": "2019-08-24T14:15:22Z",        "context_updated_at": "2019-08-24T14:15:22Z",        "metadata_updated_at": "2019-08-24T14:15:22Z",        "public_id_updated_at": "2019-08-24T14:15:22Z",        "tags_updated_at": "2019-08-24T14:15:22Z",        "updated_at": "2019-08-24T14:15:22Z"      },      "next_cursor": "string",      "derived": [        {          "transformation": "string",          "format": "string",          "bytes": 0,          "id": "string",          "url": "http://example.com",          "secure_url": "http://example.com"        }      ],      "faces": [        [          0        ]      ],      "coordinates": {        "faces": [          [            0          ]        ],        "custom": [          [            0          ]        ]      },      "illustration_score": 0,      "semi_transparent": true,      "grayscale": true,      "colors": [        []      ],      "predominant": {        "property1": [          []        ],        "property2": [          []        ]      },      "versions": [        {          "version_id": "string",          "version": "string",          "format": "string",          "size": 0,          "time": "2019-08-24T14:15:22Z",          "restorable": true        }      ],      "info": {},      "derivatives": [        {          "id": "string",          "transformation": "string",          "transformation_signature": "string",          "secure_url": "http://example.com"        }      ]    }  ],  "next_cursor": "string",  "total_count": 0}