---
canonical_url: "https://docs.composio.dev/toolkits/withpica"
markdown_url: "https://docs.composio.dev/toolkits/withpica.md"
product: "platform"
version: null
last_updated: null
---

# withPICA

withPICA is a music rights and catalog platform for managing works, recordings, credits, agreements, royalties, collaborators, and related assets.

- **Category:** lifestyle & entertainment
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 10
- **Triggers:** 0
- **Slug:** `WITHPICA`
- **Version:** 00000000_00

## Tools

### Get Current User

**Slug:** `WITHPICA_GET_CURRENT_USER`

Return the connected withPICA user's profile and linked catalog person ID.

#### 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 Person

**Slug:** `WITHPICA_GET_PERSON`

Return detailed catalog information for one person by ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `person_id` | string | Yes | Catalog person ID, such as linked_person_id from GET_CURRENT_USER or an ID from LIST_PEOPLE. |

#### 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 Workspace Context

**Slug:** `WITHPICA_GET_WORKSPACE_CONTEXT`

Return the connected organisation, catalog counts, health summary, and current priorities.

#### 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 |

### List Agreements

**Slug:** `WITHPICA_LIST_AGREEMENTS`

Search and filter agreements, including signature and expiry states, one page at a time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum agreements in this page (1-500). |
| `query` | string | No | Text to search for across agreements. |
| `status` | string | No | Filter by agreement status. |
| `party_name` | string | No | Filter by a party's name. |
| `next_cursor` | string | No | Opaque cursor from the previous response; omit for the first page. |
| `has_end_date` | boolean | No | Return dated agreements when true, or open-ended agreements when false. |
| `agreement_type` | string | No | Filter by agreement type. |
| `awaiting_signature` | boolean | No | When true, return agreements pending one or more signatures. |
| `include_work_counts` | boolean | No | Include linked-work counts for each agreement. |
| `expiring_within_days` | integer | No | Return active agreements ending within this many days; must be non-negative. |

#### 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 |

### List Agreement Templates

**Slug:** `WITHPICA_LIST_AGREEMENT_TEMPLATES`

Return the active and system agreement templates available to the organisation.

#### 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 |

### List People

**Slug:** `WITHPICA_LIST_PEOPLE`

Search and filter people in the organisation's catalog, returning one page and a continuation cursor.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tags` | array | No | Return people carrying any of these tags. |
| `limit` | integer | No | Maximum people in this page (1-500). |
| `query` | string | No | Text to match against people; omit to browse all people. |
| `roles` | array | No | Return people holding any of these roles. |
| `has_email` | boolean | No | Return only people with an email when true, or without one when false. |
| `has_phone` | boolean | No | Return only people with a phone number when true, or without one when false. |
| `next_cursor` | string | No | Opaque cursor from the previous response; omit for the first page. |
| `record_kind` | string ("individual" | "placeholder" | "artefact") | No | Filter by whether records represent individuals, placeholder credits, or parsing artefacts. |
| `outreach_state` | string ("ready" | "needs_email" | "needs_disambiguation" | "not_a_target" | "do_not_contact" | "previously_declined") | No | Filter by contact-readiness state. |

#### 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 |

### List Projects

**Slug:** `WITHPICA_LIST_PROJECTS`

Return a bounded list of projects in the connected organisation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum projects to return; must be at least 1. |

#### 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 |

### List Sessions

**Slug:** `WITHPICA_LIST_SESSIONS`

Return a bounded list of recording or creative sessions in the connected organisation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum sessions to return; must be at least 1. |

#### 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 |

### List Works

**Slug:** `WITHPICA_LIST_WORKS`

Return a bounded page of musical works in the organisation's catalog.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum works to return in this call; must be at least 1. |
| `next_cursor` | string | No | Opaque cursor from the previous response; omit for the first page. |

#### 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 |

### Search Recordings

**Slug:** `WITHPICA_SEARCH_RECORDINGS`

Search recordings by title, artist name, or ISRC and return one result page with recovery guidance.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum recordings in this page (1-500). |
| `query` | string | Yes | Recording title, artist name, or ISRC to search for. |
| `next_cursor` | string | No | Opaque cursor from the previous response; omit for the first page. |

#### 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 |