# Cincopa

Cincopa is a comprehensive media platform offering tools for uploading, managing, and customizing multimedia content, including videos, images, and audio, with robust APIs for seamless integration.

- **Category:** video & audio
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 5
- **Triggers:** 0
- **Slug:** `CINCOPA`
- **Version:** 20260223_00

## Tools

### Upload Asset From URL

**Slug:** `CINCOPA_ASSET_UPLOAD_FROM_URL`

Tool to upload a new asset directly from a provided external URL and receive a status ID for tracking. Use when you need to import media from a remote source and optionally specify a gallery or existing asset.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `fid` | string | No | Unique identifier for the gallery where the asset should be uploaded. Required when adding to a gallery. |
| `rid` | string | No | Unique identifier for an existing asset to attach this asset to. If provided, 'type' must also be specified. |
| `type` | string | No | Defines the type of the attached asset. Default is 'thumb'. |
| `input` | string | Yes | The URL of the source asset to be uploaded. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Abort Asset Upload From URL

**Slug:** `CINCOPA_ASSET_UPLOAD_FROM_URL_ABORT`

Tool to abort an ongoing asset upload-in-progress by providing its status ID. Use when an upload is no longer needed, was initiated by mistake, or is taking too long.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `status_id` | string | Yes | Unique identifier of the in-progress upload to abort. This is returned when the upload was first initiated. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Asset Upload From URL Status

**Slug:** `CINCOPA_ASSET_UPLOAD_FROM_URL_GET_STATUS`

Tool to check the status of an asset upload initiated via URL by its status ID. Use after calling 'Upload Asset From URL' to poll for completion.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `status_id` | string | Yes | Unique identifier for the upload process, returned by the initial 'Upload Asset From URL' call. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Upload Iframe

**Slug:** `CINCOPA_GET_UPLOAD_IFRAME`

Tool to get an upload iframe URL for embedding an upload widget. Use when you need to generate an HTML iframe for uploading media to a Cincopa gallery.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `fid` | string | No | A unique identifier for a gallery. This parameter is used to specify the target gallery where the asset should be added. |
| `rrid` | string | No | A remote resource ID that serves as a reference to a remote object, such as an entity in a CRM or CMS. This can be used as an alternative to fid when linking assets to external systems. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Validate API Connection

**Slug:** `CINCOPA_PING`

Tool to validate API connection. Use after obtaining a valid api_token to confirm connectivity.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |