> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# withPICA

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

![withPICA logo](https://mintcdn.com/composio-preview/DMB8UrgJmE7r-ZQ5/images/toolkits/withpica.svg?fit=max\&auto=format\&n=DMB8UrgJmE7r-ZQ5\&q=85\&s=8ba77ea9065631a8f169fce13c3ce486)

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

## Tools

> [accordion] Get Current User
>
> **Slug:** `WITHPICA_GET_CURRENT_USER`
>
> Return the connected withPICA user's profile and linked catalog person ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Person
>
> **Slug:** `WITHPICA_GET_PERSON`
>
> Return detailed catalog information for one person by ID.
>
> #### Input Parameters
>
> **person\_id** `string` *required*
>
> Catalog person ID, such as linked\_person\_id from GET\_CURRENT\_USER or an ID from LIST\_PEOPLE.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Workspace Context
>
> **Slug:** `WITHPICA_GET_WORKSPACE_CONTEXT`
>
> Return the connected organisation, catalog counts, health summary, and current priorities.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Agreements
>
> **Slug:** `WITHPICA_LIST_AGREEMENTS`
>
> Search and filter agreements, including signature and expiry states, one page at a time.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum agreements in this page (1-500).
>
> **query** `string`
>
> Text to search for across agreements.
>
> **status** `string`
>
> Filter by agreement status.
>
> **party\_name** `string`
>
> Filter by a party's name.
>
> **next\_cursor** `string`
>
> Opaque cursor from the previous response; omit for the first page.
>
> **has\_end\_date** `boolean`
>
> Return dated agreements when true, or open-ended agreements when false.
>
> **agreement\_type** `string`
>
> Filter by agreement type.
>
> **awaiting\_signature** `boolean`
>
> When true, return agreements pending one or more signatures.
>
> **include\_work\_counts** `boolean`
>
> Include linked-work counts for each agreement.
>
> **expiring\_within\_days** `integer`
>
> Return active agreements ending within this many days; must be non-negative.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Agreement Templates
>
> **Slug:** `WITHPICA_LIST_AGREEMENT_TEMPLATES`
>
> Return the active and system agreement templates available to the organisation.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List People
>
> **Slug:** `WITHPICA_LIST_PEOPLE`
>
> Search and filter people in the organisation's catalog, returning one page and a continuation cursor.
>
> #### Input Parameters
>
> **tags** `array`
>
> Return people carrying any of these tags.
>
> **limit** `integer`
>
> Maximum people in this page (1-500).
>
> **query** `string`
>
> Text to match against people; omit to browse all people.
>
> **roles** `array`
>
> Return people holding any of these roles.
>
> **has\_email** `boolean`
>
> Return only people with an email when true, or without one when false.
>
> **has\_phone** `boolean`
>
> Return only people with a phone number when true, or without one when false.
>
> **next\_cursor** `string`
>
> Opaque cursor from the previous response; omit for the first page.
>
> **record\_kind** `string ("individual" | "placeholder" | "artefact")`
>
> 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")`
>
> Filter by contact-readiness state.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Projects
>
> **Slug:** `WITHPICA_LIST_PROJECTS`
>
> Return a bounded list of projects in the connected organisation.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum projects to return; must be at least 1.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Sessions
>
> **Slug:** `WITHPICA_LIST_SESSIONS`
>
> Return a bounded list of recording or creative sessions in the connected organisation.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum sessions to return; must be at least 1.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Works
>
> **Slug:** `WITHPICA_LIST_WORKS`
>
> Return a bounded page of musical works in the organisation's catalog.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum works to return in this call; must be at least 1.
>
> **next\_cursor** `string`
>
> Opaque cursor from the previous response; omit for the first page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Recordings
>
> **Slug:** `WITHPICA_SEARCH_RECORDINGS`
>
> Search recordings by title, artist name, or ISRC and return one result page with recovery guidance.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum recordings in this page (1-500).
>
> **query** `string` *required*
>
> Recording title, artist name, or ISRC to search for.
>
> **next\_cursor** `string`
>
> Opaque cursor from the previous response; omit for the first page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
