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

# Podio

Podio is a collaborative work platform for managing app-based workflows, items, tasks, files, comments, and related business data.

- **Category:** project management
- **Auth:** OAUTH2
- **Composio-managed OAuth available?** No
- **Tools:** 143
- **Triggers:** 0
- **Slug:** `PODIO`
- **Version:** 00000000_00

## Tools

### Activate App

**Slug:** `PODIO_ACTIVATE_APP`

Activate a deactivated Podio app, restoring it to the app navigator and allowing new item creation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `app_id` | integer | Yes | ID of the app to activate. |

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

### Add New App

**Slug:** `PODIO_ADD_NEW_APP`

Create a Podio app on a space with its configuration and fields.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `config` | object | Yes | Configuration of the new app. |
| `fields` | array | No | Fields to add to the app. |
| `silent` | boolean | No | Whether to avoid stream bumps and notifications. Defaults to false. |
| `space_id` | integer | Yes | ID of the space on which to place the app. |

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

### Add New App Field

**Slug:** `PODIO_ADD_NEW_APP_FIELD`

Add a field to a Podio app.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string | Yes | Podio field type. |
| `app_id` | integer | Yes | ID of the app receiving the field. |
| `config` | object | Yes | Configuration of the new field. |

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

### Add New Organization

**Slug:** `PODIO_ADD_NEW_ORGANIZATION`

Create a new Podio organization. This administrative action creates a new organization visible to its members.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `logo` | integer | No | Optional file ID for the organization logo. |
| `name` | string | Yes | Name of the new organization. |

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

### Archive Space

**Slug:** `PODIO_ARCHIVE_SPACE`

Archive a Podio space, hiding it from navigation without deleting its contents.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `space_id` | integer | Yes | ID of the space to archive. |

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

### Assign Task

**Slug:** `PODIO_ASSIGN_TASK`

Assign a Podio task to a user, or remove its responsible user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `silent` | boolean | No | Whether to suppress stream bumps and notifications. |
| `task_id` | integer | Yes | Podio task ID to assign. |
| `responsible` | string | Yes | User ID to make responsible, or null to leave the task unassigned. |

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

### Bulk Delete Items

**Slug:** `PODIO_BULK_DELETE_ITEMS`

Permanently delete explicitly selected or filter-matched items from an app and remove them from all views. Deleted data cannot be retrieved.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `app_id` | integer | Yes | Podio app ID containing the items. |
| `silent` | boolean | No | Whether to suppress stream bumps and notifications. |
| `filters` | object | No | Filters selecting items to delete; ignored when item_ids is set. |
| `view_id` | integer | No | Saved view whose matching items should be deleted; ignored when item_ids is set. |
| `item_ids` | array | No | Explicit item IDs to permanently delete. |

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

### Calculate Items

**Slug:** `PODIO_CALCULATE_ITEMS`

Calculate an aggregation over items in a Podio app, optionally grouped and filtered.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of grouped results. |
| `app_id` | integer | Yes | Podio app ID whose items should be calculated. |
| `filters` | array | No | Optional calculation filters with key and values. |
| `formula` | array | No | Ordered formula parts with type and value. |
| `groupings` | array | No | Optional field or revision groupings. |
| `aggregation` | string ("sum" | "average" | "count" | "mininum" | "maximum") | Yes | Aggregation to perform; Podio documents 'mininum' with this spelling. |

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

### Clone Item

**Slug:** `PODIO_CLONE_ITEM`

Create a new item in the same app with values identical to the selected item.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `silent` | boolean | No | Whether to suppress stream bumps and notifications. |
| `item_id` | integer | Yes | Podio item ID to clone. |

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

### Complete Task

**Slug:** `PODIO_COMPLETE_TASK`

Mark a Podio task complete. Completing a recurring task may create its next task and return that task's ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `hook` | boolean | No | Whether Podio hooks should run for this change. |
| `silent` | boolean | No | Whether to suppress stream bumps and notifications. |
| `task_id` | integer | Yes | Podio task ID to change. |

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

### Create Comment

**Slug:** `PODIO_CREATE_COMMENT`

Add a comment to a Podio object, optionally attaching uploaded files or an embedded link. Setting alert_invite to true may also invite mentioned users who lack access to the workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `hook` | boolean | No | Whether Podio hooks should run for this change. |
| `value` | string | Yes | Comment text. |
| `silent` | boolean | No | If true, do not bump the object in the stream or generate notifications. |
| `embed_id` | integer | No | Existing Podio embed ID to attach. |
| `file_ids` | array | No | Temporary uploaded file IDs to attach. |
| `embed_url` | string | No | URL to attach as an embedded link. |
| `external_id` | string | No | External-system identifier for the comment. |
| `alert_invite` | boolean | No | Whether mentioned users may be invited to the workspace when they need access to the commented object. |
| `reference_id` | integer | Yes | ID of the Podio object to comment on. |
| `reference_type` | string | Yes | Podio reference type of the object to comment on, such as item or task. Podio does not publish an exhaustive list. |

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

### Create Item

**Slug:** `PODIO_CREATE_ITEM`

Create an item in a Podio app using field IDs or external IDs, with optional files, tags, reminder, recurrence, and reference.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ref` | object | No | Optional reference to another Podio item. |
| `hook` | boolean | No | Whether Podio hooks should run for this change. |
| `tags` | array | No | Tags to add to the item. |
| `app_id` | integer | Yes | Podio app ID whose field definitions govern the new item. |
| `fields` | object | Yes | Map of app field ID or external ID to its Podio field value. Values may be scalars, objects, or lists in the shape required by that field type. |
| `silent` | boolean | No | If true, do not bump the item in the stream or generate notifications. |
| `file_ids` | array | No | Temporary uploaded file IDs to attach. |
| `reminder` | object | No | Optional reminder configuration. |
| `recurrence` | object | No | Optional recurrence configuration. |
| `external_id` | string | No | External-system identifier for the item. |
| `linked_account_id` | integer | No | Linked account to use for a meeting item. |

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

### Create Organization App Store Profile

**Slug:** `PODIO_CREATE_ORGANIZATION_APP_STORE_PROFILE`

Administratively create an app-store profile for a Podio organization when one does not already exist.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `fields` | object | Yes | App-store profile fields using Podio contact-area field names and values. These are sent as the top-level request body. |
| `org_id` | integer | Yes | Podio organization 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 |

### Create Referenced Task

**Slug:** `PODIO_CREATE_REFERENCED_TASK`

Create a Podio task attached through the reference-specific task route.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `hook` | boolean | No | Whether Podio hooks should run for this change. |
| `text` | string | Yes | Task title text. |
| `due_on` | string | No | UTC due date and time. |
| `labels` | array | No | Label names to apply. |
| `ref_id` | integer | Yes | ID of the Podio object to reference. |
| `silent` | boolean | No | Whether to suppress stream bumps and notifications. |
| `private` | boolean | No | Whether the task is private. |
| `due_date` | string | No | Local due date. |
| `due_time` | string | No | Local due time. |
| `file_ids` | array | No | File IDs to attach. |
| `ref_type` | string ("item" | "status" | "app" | "space" | "conversation") | Yes | Type of Podio object to reference. |
| `reminder` | object | No | Task reminder. |
| `label_ids` | array | No | Label IDs to apply. |
| `recurrence` | object | No | Task recurrence. |
| `description` | string | No | Task description. |
| `external_id` | string | No | External-system task ID. |
| `responsible` | string | No | Contact or contacts responsible for the task. |

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

### Create Space

**Slug:** `PODIO_CREATE_SPACE`

Create a new Podio space in an organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the new space. |
| `org_id` | integer | Yes | ID of the organization that will contain the space. |
| `privacy` | string ("open" | "closed") | No | Privacy level of the space. Defaults to closed. |
| `auto_join` | boolean | No | Whether new employees should be joined automatically. |
| `post_on_new_app` | boolean | No | Whether new apps should be announced with a status update. |
| `post_on_new_member` | boolean | No | Whether new members should be announced with a status update. |

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

### Create Task

**Slug:** `PODIO_CREATE_TASK`

Create a personal or referenced Podio task with assignment, due date, labels, files, reminder, and recurrence.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `hook` | boolean | No | Whether Podio hooks should run for this change. |
| `text` | string | Yes | Task title text. |
| `due_on` | string | No | Due date and time in UTC, formatted YYYY-MM-DD HH:MM:SS. |
| `labels` | array | No | Labels to apply in text form. |
| `ref_id` | integer | No | ID of the Podio object to which the task is attached. |
| `silent` | boolean | No | If true, do not bump the task in the stream or generate notifications. |
| `private` | boolean | No | Whether the task is private. |
| `due_date` | string | No | Due date in the connected user's local time, formatted YYYY-MM-DD. |
| `due_time` | string | No | Due time in the connected user's local time. |
| `file_ids` | array | No | File IDs to attach to the task. |
| `ref_type` | string | No | Podio object type to which the task is attached. |
| `reminder` | object | No | Reminder configuration for the task. |
| `label_ids` | array | No | Label IDs to apply to the task. |
| `recurrence` | object | No | Recurrence configuration for the task. |
| `description` | string | No | Task description. |
| `external_id` | string | No | External-system identifier for the task. |
| `responsible` | string | No | Responsible contact or contacts, as a user ID, a typed contact identifier, or a list containing either form. |

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

### Create Task Label

**Slug:** `PODIO_CREATE_TASK_LABEL`

Create a personal Podio task label with a name and hex color.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `text` | string | Yes | Name of the task label. |
| `color` | string | Yes | Six-character hexadecimal label color without a leading hash. |

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

### Deactivate App

**Slug:** `PODIO_DEACTIVATE_APP`

Deactivate a Podio app, removing it from the app navigator and preventing new item creation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `app_id` | integer | Yes | ID of the app to deactivate. |

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

### Delete App

**Slug:** `PODIO_DELETE_APP`

Permanently delete a Podio app and all of its items, widgets, filters, and shares. This cannot be reversed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `app_id` | integer | Yes | ID of the app to delete. |
| `silent` | boolean | No | Whether to avoid stream bumps and notifications. Defaults to false. |

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

### Delete App Field

**Slug:** `PODIO_DELETE_APP_FIELD`

Remove a field from new and updated app items. Existing items retain the field unless delete_values is true.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `app_id` | integer | Yes | ID of the app containing the field. |
| `field_id` | integer | Yes | ID of the field to delete. |
| `delete_values` | boolean | No | Whether to delete stored values for the field. Defaults to false. |

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

### Delete Comment

**Slug:** `PODIO_DELETE_COMMENT`

Delete one Podio comment by ID; use only for a comment the caller intends to remove.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `hook` | boolean | No | Whether Podio hooks should run for this deletion. Defaults to true. |
| `comment_id` | integer | Yes | Podio comment ID to delete. |

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

### Delete Item

**Slug:** `PODIO_DELETE_ITEM`

Delete one Podio item by ID; use only for an item the caller intends to remove.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `hook` | boolean | No | Whether Podio hooks should run for this change. Defaults to true. |
| `silent` | boolean | No | Whether to avoid bumping the item in the stream and generating notifications. Defaults to false. |
| `item_id` | integer | Yes | Podio item ID to delete. |

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

### Delete Item Reference

**Slug:** `PODIO_DELETE_ITEM_REFERENCE`

Remove the reference currently attached to a Podio item, if any.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `item_id` | integer | Yes | Podio item ID whose reference should be removed. |

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

### Delete Organization App Store Profile

**Slug:** `PODIO_DELETE_ORGANIZATION_APP_STORE_PROFILE`

Permanently delete an organization's app-store profile. This destructive administrative action removes the profile rather than clearing individual fields.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org_id` | integer | Yes | Podio organization 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 |

### Delete Organization Member Role

**Slug:** `PODIO_DELETE_ORGANIZATION_MEMBER_ROLE`

Remove a user's organization-level role. This destructive administrative action changes the user's authorization in the organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org_id` | integer | Yes | Podio organization ID. |
| `user_id` | integer | Yes | Podio user ID of the organization member. |

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

### Delete Space

**Slug:** `PODIO_DELETE_SPACE`

Permanently delete a Podio space, ending all of its memberships and cancelling all outstanding space invitations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `space_id` | integer | Yes | ID of the space to permanently delete. |

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

### Delete Task

**Slug:** `PODIO_DELETE_TASK`

Delete one Podio task by ID; use only for a task the caller intends to remove.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `hook` | boolean | No | Whether Podio hooks should run for this change. Defaults to true. |
| `silent` | boolean | No | Whether to avoid bumping the task in the stream and generating notifications. Defaults to false. |
| `task_id` | integer | Yes | Podio task ID to delete. |

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

### Delete Task Label

**Slug:** `PODIO_DELETE_TASK_LABEL`

Delete one personal Podio task label.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `label_id` | integer | Yes | Podio task label 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 |

### Delete User Property

**Slug:** `PODIO_DELETE_USER_PROPERTY`

Delete one auth-client-specific property from the active Podio user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Auth-client-specific user property name. |

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

### End Organization Membership

**Slug:** `PODIO_END_ORGANIZATION_MEMBERSHIP`

Permanently end a user's membership in every space in an organization. This destructive administrative action promotes other users where the target is the last admin and deletes workspaces where the target is the only member.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org_id` | integer | Yes | Podio organization ID. |
| `user_id` | integer | Yes | Podio user ID of the organization member. |

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

### Export Items

**Slug:** `PODIO_EXPORT_ITEMS`

Create a Podio batch that exports app items in XLS or XLSX format.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of items to export. |
| `app_id` | integer | Yes | Podio app ID to export. |
| `offset` | integer | No | Offset into matching items. |
| `filters` | object | No | Item filters to apply. |
| `sort_by` | string | No | Sort order when no predefined filter is used. |
| `view_id` | integer | No | Saved view ID; zero means the last-used view. |
| `exporter` | string ("xls" | "xlsx") | Yes | Spreadsheet export format. |
| `sort_desc` | boolean | No | Whether to sort descending. |
| `split_email_by_type` | boolean | No | Whether to split email values by type. |
| `split_phone_by_type` | boolean | No | Whether to split phone values by type. |

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

### Filter Items By View

**Slug:** `PODIO_FILTER_ITEMS_BY_VIEW`

Retrieve items from a Podio app using a saved view and optional paging or sorting overrides. Setting remember persists the view selection.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of items to return. |
| `app_id` | integer | Yes | Podio app ID containing the view. |
| `offset` | integer | No | Offset into matching items. |
| `sort_by` | string | No | Override for the view's sort order. |
| `view_id` | integer | Yes | Saved view ID to apply. |
| `remember` | boolean | No | Whether to remember this view for the user. |
| `sort_desc` | boolean | No | Override for descending sort order. |

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

### Find Referenceable Items

**Slug:** `PODIO_FIND_REFERENCEABLE_ITEMS`

Search the apps allowed by a Podio reference field for items matching text.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `text` | string | No | Case-insensitive wildcard search text. |
| `limit` | integer | No | Maximum number of results. |
| `field_id` | integer | Yes | App reference field ID. |
| `not_item_id` | array | No | Item IDs to exclude from results. |

#### 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 Admin Organizations by Email

**Slug:** `PODIO_GET_ADMIN_ORGS_BY_EMAIL`

Look up organizations administered by an email address and free organizations containing it. This administrative lookup exposes organization membership and domain information.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address whose administrative and free organizations should be returned. |

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

**Slug:** `PODIO_GET_ALL_APPS`

Search apps available to the connected user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `text` | string | No | Text to match against app, item, or workspace names. |
| `limit` | integer | No | Maximum number of apps to return. Defaults to 4. |
| `order` | string ("score" | "name") | No | Order apps by relevance score or name. |
| `right` | string | No | Right the user must have on returned apps. |
| `exclude_demo` | boolean | No | Whether to exclude apps from the demo workspace. |
| `exclude_app_ids` | string | No | Comma-separated app IDs to exclude. |
| `target_space_id` | integer | No | Preferred space ID for returned apps. |
| `referenceable_in_org` | integer | No | Return apps referenceable in this organization 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 All Spaces on Organization

**Slug:** `PODIO_GET_ALL_SPACES_ON_ORGANIZATION`

As an organization administrator, list every workspace in the organization. Names and URLs are omitted for workspaces the administrator has not joined.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org_id` | integer | Yes | Podio organization 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 App

**Slug:** `PODIO_GET_APP`

Return a Podio app's metadata and field definitions so an agent can construct valid item values.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `app_id` | integer | Yes | Podio app ID returned by List Apps. |

#### 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 App by Organization, Space, and App Labels

**Slug:** `PODIO_GET_APP_BY_LABELS`

Get a Podio app using its organization, space, and app URL labels.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `app_label` | string | Yes | App URL label. |
| `org_label` | string | Yes | Organization URL label. |
| `space_label` | string | Yes | Space URL label. |

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

**Slug:** `PODIO_GET_APP_DEPENDENCIES`

Get the apps an app depends on and the dependency graph.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `app_id` | integer | Yes | ID of the app to inspect. |

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

**Slug:** `PODIO_GET_APP_FIELD`

Get one Podio app field by numeric ID or external ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `app_id` | integer | Yes | ID of the app containing the field. |
| `field_or_external_id` | string | Yes | Numeric field ID or stable external field 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 App Inverse Dependencies

**Slug:** `PODIO_GET_APP_INVERSE_DEPENDENCIES`

Get apps and fields that depend on a Podio app.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `app_id` | integer | Yes | ID of the referenced app. |

#### 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 App on Space by URL Label

**Slug:** `PODIO_GET_APP_ON_SPACE_BY_URL_LABEL`

Get a Podio app in a space by its URL label.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `space_id` | integer | Yes | ID of the app's space. |
| `url_label` | string | Yes | URL label of the app. |

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

**Slug:** `PODIO_GET_AVAILABLE_SEATS`

Return the available employee and external seats in a Podio space.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `space_id` | integer | Yes | ID of the space whose seats to inspect. |

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

**Slug:** `PODIO_GET_AVAILABLE_SPACES`

List open Podio spaces in an organization that the connected user can join.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org_id` | integer | Yes | ID of the organization to inspect. |

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

**Slug:** `PODIO_GET_COMMENT`

Return one Podio comment by ID, including files, embeds, likes, and questions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `comment_id` | integer | Yes | Podio comment ID returned by List Comments or Create Comment. |

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

**Slug:** `PODIO_GET_COMMENT_REVISIONS`

Return all revisions of a Podio comment, including the current revision, ordered oldest first.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `comment_id` | integer | Yes | Podio comment ID whose revision history to return. |

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

**Slug:** `PODIO_GET_CURRENT_USER`

Return the connected Podio user's identity, profile, locale, timezone, and account status.

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

**Slug:** `PODIO_GET_FEATURES`

Get features available from selected Podio apps.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `app_ids` | string | No | Comma-separated app IDs from which to extract features. |
| `include_space` | boolean | No | Whether to include features from the containing space. |

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

**Slug:** `PODIO_GET_FIELD_RANGES`

Return the minimum and maximum values for a number, calculation, or money field.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `field_id` | integer | Yes | Number, calculation, or money field 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 Icon Suggestions

**Slug:** `PODIO_GET_ICON_SUGGESTIONS`

Search Podio app icon suggestions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | No | Search term to match against app icons. |

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

**Slug:** `PODIO_GET_ITEM`

Return one Podio item with its app, field values, revisions, comments, files, tags, references, and rights. By default, this also marks new item notifications as viewed; set mark_as_viewed to false to avoid that side effect.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `item_id` | integer | Yes | Podio item ID returned by List Items or Create Item. |
| `mark_as_viewed` | boolean | No | Whether to mark new notifications on this item as viewed. Defaults to true. |

#### 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 Item By App Item ID

**Slug:** `PODIO_GET_ITEM_BY_APP_ITEM_ID`

Return a full Podio item using its app ID and app-local item ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `app_id` | integer | Yes | Podio app ID. |
| `app_item_id` | integer | Yes | Item's app-local sequential 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 Item By External ID

**Slug:** `PODIO_GET_ITEM_BY_EXTERNAL_ID`

Return a Podio app item using its external-system identifier.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `app_id` | integer | Yes | Podio app ID. |
| `external_id` | string | Yes | External-system identifier stored on the item. |

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

**Slug:** `PODIO_GET_ITEM_CLONE`

Return unsaved clone-ready values for a Podio item; this does not create an item.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `item_id` | integer | Yes | Podio item ID whose clone-ready values should be returned. |

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

**Slug:** `PODIO_GET_ITEM_COUNT`

Count items in a Podio app matching a saved view or documented scalar filters.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `app_id` | integer | Yes | Podio app ID whose items should be counted. |
| `filters` | object | No | Documented filter keys mapped to scalar or semicolon/range-encoded values. |
| `view_id` | integer | No | Saved view ID; zero applies the last-used view. |

#### 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 Item Field Values

**Slug:** `PODIO_GET_ITEM_FIELD_VALUES`

Return values for one numeric field ID on a Podio item.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `item_id` | integer | Yes | Podio item ID. |
| `field_id` | integer | Yes | App field ID whose values should be returned. |

#### 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 Item Field Values V2

**Slug:** `PODIO_GET_ITEM_FIELD_VALUES_V2`

Return values for a Podio item field selected by numeric ID or external ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `item_id` | integer | Yes | Podio item ID. |
| `field_or_external_id` | string | Yes | Numeric field ID or field external 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 Item Preview For Field Reference

**Slug:** `PODIO_GET_ITEM_PREVIEW_FOR_FIELD_REFERENCE`

Return an item preview formatted for use by a specific Podio reference field.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `item_id` | integer | Yes | Podio item ID to preview. |
| `field_id` | integer | Yes | Reference field ID that governs the preview. |

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

**Slug:** `PODIO_GET_ITEM_REFERENCES`

Return up to the requested limit of items that reference a Podio item, grouped by app and field.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of referencing items to return. |
| `item_id` | integer | Yes | Podio item ID whose incoming references should be returned. |

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

**Slug:** `PODIO_GET_ITEM_REVISION`

Return metadata for a specific revision of a Podio item.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `item_id` | integer | Yes | Podio item ID. |
| `revision` | integer | Yes | Revision number to return. |

#### 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 Item Revision Difference

**Slug:** `PODIO_GET_ITEM_REVISION_DIFFERENCE`

Return field-value differences between two revisions of a Podio item.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `item_id` | integer | Yes | Podio item ID. |
| `revision_to` | integer | Yes | Later revision number. |
| `revision_from` | integer | Yes | Earlier revision number. |

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

**Slug:** `PODIO_GET_ITEM_REVISIONS`

Return up to the latest 30 revisions of a Podio item.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `item_id` | integer | Yes | Podio item 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 Items As XLSX

**Slug:** `PODIO_GET_ITEMS_AS_XLSX`

Download up to 1000 filtered Podio app items as an XLSX file.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of items to export, up to 1000. |
| `app_id` | integer | Yes | Podio app ID to export. |
| `offset` | integer | No | Offset into matching items. |
| `filters` | object | No | Documented filter keys mapped to scalar or semicolon/range-encoded values. |
| `sort_by` | string | No | Documented item sort key. |
| `view_id` | integer | No | Saved view ID; zero applies the last-used view. |
| `sort_desc` | boolean | No | Whether to sort descending. |
| `deleted_columns` | boolean | No | Whether to include deleted columns. |

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

**Slug:** `PODIO_GET_ITEM_VALUES`

Return all populated fields and values for a Podio item.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `item_id` | integer | Yes | Podio item 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 Item Values V2

**Slug:** `PODIO_GET_ITEM_VALUES_V2`

Return the field values on a Podio item using the v2 value representation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `item_id` | integer | Yes | Podio item 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 Meeting URL

**Slug:** `PODIO_GET_MEETING_URL`

Get the join URL for a Podio meeting item. For the organizer, this request may start the meeting and return an automatic-login URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `item_id` | integer | Yes | Podio meeting item 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 Notification Setting

**Slug:** `PODIO_GET_NOTIFICATION_SETTING`

Get whether one Podio notification type is enabled for an email or mobile client.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `client_type` | string ("email" | "mobile") | Yes | Podio notification client type. |
| `notification_type` | string ("digest" | "bulletin" | "reference" | "message" | "space" | "subscription" | "user" | "reminder" | "push_notification" | "push_notification_sound" | "push_notification_browser") | Yes | Podio notification type. |

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

**Slug:** `PODIO_GET_NOTIFICATION_SETTINGS`

Get all Podio notification-type settings for an email or mobile client.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `client_type` | string ("email" | "mobile") | Yes | Podio notification client type. |

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

**Slug:** `PODIO_GET_ORGANIZATION`

Get a Podio organization by ID, including its account limits, domains, role, tier, and creator metadata.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org_id` | integer | Yes | Podio organization 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 Organization Admins

**Slug:** `PODIO_GET_ORGANIZATION_ADMINS`

List the users who administer a Podio organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org_id` | integer | Yes | Podio organization 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 Organization App Store Profile

**Slug:** `PODIO_GET_ORGANIZATION_APP_STORE_PROFILE`

Get an organization's app-store profile, including its revision and Podio contact-area fields.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org_id` | integer | Yes | Podio organization 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 Organization by URL

**Slug:** `PODIO_GET_ORGANIZATION_BY_URL`

Resolve a Podio organization from its full URL or the URL of a resource within it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | Full URL of the organization or any resource beneath it. |

#### 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 Organization Login Report

**Slug:** `PODIO_GET_ORGANIZATION_LOGIN_REPORT`

Retrieve an administrative report of total and active organization users by week. The report exposes organization-wide login activity counts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of weeks to return, counting backward from the previous week. |
| `offset` | integer | No | Offset into the weeks to return. |
| `org_id` | integer | Yes | Podio organization 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 Organization Member

**Slug:** `PODIO_GET_ORGANIZATION_MEMBER`

Get a user's member data, contact profile, role, tier, and space counts in a Podio organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org_id` | integer | Yes | Podio organization ID. |
| `user_id` | integer | Yes | Podio user ID of the organization member. |

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

**Slug:** `PODIO_GET_ORGANIZATION_MEMBERS`

As an organization administrator, list invited and active members. Invited users may expose only limited user and profile information.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of members to return. |
| `query` | string | No | Search term to match against members. |
| `offset` | integer | No | Zero-based result offset. |
| `org_id` | integer | Yes | Podio organization ID. The connected user must be an organization administrator. |
| `sort_by` | string ("name" | "last_seen_on") | No | Member sort field. |
| `sort_desc` | boolean | No | Whether to sort descending. |
| `member_type` | string ("employee" | "external" | "admin" | "regular" | "guest" | "premium") | No | Member type to return. |

#### 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 Organization Task Summary

**Slug:** `PODIO_GET_ORGANIZATION_TASK_SUMMARY`

Get task summary groups for one Podio organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of tasks returned in each summary group. |
| `org_id` | integer | Yes | Podio organization 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 Personal Task Summary

**Slug:** `PODIO_GET_PERSONAL_TASK_SUMMARY`

Get summary groups for personal tasks and personal-space tasks.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of tasks returned in each summary group. |

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

**Slug:** `PODIO_GET_PROFILE_FIELD`

Get one contact-area profile field for the active Podio user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `key` | string | Yes | Podio contact-area key of the active user's profile field. |

#### 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 Recalculation Status For Field

**Slug:** `PODIO_GET_RECALC_STATUS_FOR_FIELD`

Return recalculation status for a calculation field on a Podio item.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `item_id` | integer | Yes | Podio item ID. |
| `field_id` | integer | Yes | Calculation field 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 References To Item By Field

**Slug:** `PODIO_GET_REFERENCES_TO_ITEM_BY_FIELD`

Return items that reference a Podio item through one specific app field.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of referencing items. |
| `offset` | integer | No | Offset into referencing items. |
| `item_id` | integer | Yes | Podio item ID being referenced. |
| `field_id` | integer | Yes | Reference field 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 Reference Task Count

**Slug:** `PODIO_GET_REFERENCE_TASK_COUNT`

Get the total number of open tasks on a referenced Podio object.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ref_id` | integer | Yes | ID of the referenced Podio object. |
| `ref_type` | string | Yes | Podio type of the referenced object. |

#### 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 Reference Task Summary

**Slug:** `PODIO_GET_REFERENCE_TASK_SUMMARY`

Get task summary groups for one referenced Podio object.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of tasks returned in each summary group. |
| `ref_id` | integer | Yes | ID of the referenced Podio object. |
| `ref_type` | string | Yes | Podio type of the referenced object. |

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

**Slug:** `PODIO_GET_SHARED_ORGANIZATIONS`

List organizations and spaces that the connected user shares with another Podio user, sorted by name.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | integer | Yes | Podio user ID to compare with the connected user. |

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

**Slug:** `PODIO_GET_SPACE`

Return a Podio space by ID, including its settings, rights, creator, and membership state.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `space_id` | integer | Yes | ID of the space to return. |

#### 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 Space App Dependencies

**Slug:** `PODIO_GET_SPACE_APP_DEPENDENCIES`

Get apps on a Podio space and their dependency graph.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `space_id` | integer | Yes | ID of the space to inspect. |

#### 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 Space by Organization and URL Label

**Slug:** `PODIO_GET_SPACE_BY_ORG_AND_URL_LABEL`

Return a Podio space using its organization ID and URL label.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org_id` | integer | Yes | ID of the organization containing the space. |
| `url_label` | string | Yes | URL label of the space. |

#### 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 Space by URL

**Slug:** `PODIO_GET_SPACE_BY_URL`

Resolve a Podio space and its organization from a full URL or organization and space slugs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | No | Full Podio resource or space URL to resolve. |
| `org_slug` | string | No | Organization slug to search within. |
| `space_slug` | string | No | Space URL slug to search for. |

#### 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 Space Memberships for Organization Member

**Slug:** `PODIO_GET_SPACE_MEMBERSHIPS_FOR_ORG_MEMBER`

As an organization administrator, list a member's workspace memberships. Sensitive workspace names and URLs are hidden when the requesting administrator is not a workspace member.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org_id` | integer | Yes | Podio organization ID. |
| `user_id` | integer | Yes | Podio user ID of the organization member. |

#### 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 Space Task Summary

**Slug:** `PODIO_GET_SPACE_TASK_SUMMARY`

Get task summary groups for one Podio space.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of tasks returned in each summary group. |
| `space_id` | integer | Yes | Podio space 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 Task

**Slug:** `PODIO_GET_TASK`

Return one Podio task with assignment, due dates, reference, labels, files, recurrence, and comments.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `task_id` | integer | Yes | Podio task ID returned by List Tasks or Create Task. |

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

**Slug:** `PODIO_GET_TASK_SUMMARY`

Get the connected user's overdue, today, and other task groups.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of tasks returned in each summary group. |

#### 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 Task Total By Time

**Slug:** `PODIO_GET_TASK_TOTAL_BY_TIME`

Get the number of tasks in a documented Podio time bucket.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `time` | string ("overdue" | "due" | "today" | "all") | Yes | Time bucket whose task count to return. |
| `space_id` | integer | No | Optional Podio space ID used to limit the count. |

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

**Slug:** `PODIO_GET_TASK_TOTALS`

Get active-task totals for owned and reassigned Podio tasks.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `space` | string | No | Optional semicolon-separated Podio space IDs used to limit totals. |

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

**Slug:** `PODIO_GET_TOP_APPS`

Get the connected user's top Podio apps.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of apps to return. Defaults to 4. |
| `exclude_demo` | boolean | No | Whether to exclude apps from the demo workspace. |

#### 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 Top Apps for Organization

**Slug:** `PODIO_GET_TOP_APPS_FOR_ORGANIZATION`

Get top Podio apps in an organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org_id` | integer | Yes | ID of the organization. |

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

**Slug:** `PODIO_GET_TOP_SPACES`

Return the top Podio spaces for the connected user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of spaces to return. Defaults to 6. |

#### 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 Top Values For Field

**Slug:** `PODIO_GET_TOP_VALUES_FOR_FIELD`

Return the top possible item values for a Podio field of type app.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results. |
| `field_id` | integer | Yes | App-type field ID. |
| `not_item_id` | array | No | Item IDs to exclude from results. |

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

**Slug:** `PODIO_GET_USER`

Get the active Podio user's account details.

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

**Slug:** `PODIO_GET_USER_PROPERTY`

Get an auth-client-specific JSON object property for the active Podio user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Auth-client-specific user property name. |

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

### Reopen Task

**Slug:** `PODIO_INCOMPLETE_TASK`

Mark a completed Podio task incomplete using Podio's task route.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `hook` | boolean | No | Whether Podio hooks should run for this change. |
| `silent` | boolean | No | Whether to suppress stream bumps and notifications. |
| `task_id` | integer | Yes | Podio task ID to change. |

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

### Install App

**Slug:** `PODIO_INSTALL_APP`

Install a Podio app on a space with selected features.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `app_id` | integer | Yes | ID of the app to install. |
| `features` | array | No | Features to install: filters, widgets, integration, forms, items, flows, or votings. Omit to install all except items. |
| `space_id` | integer | Yes | ID of the space where the app is installed. |

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

**Slug:** `PODIO_LIST_APPS`

List active Podio apps in a space, optionally including inactive apps.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `space_id` | integer | Yes | Space ID returned by List Spaces. |
| `include_inactive` | boolean | No | Whether to include inactive apps. Defaults to false. |

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

**Slug:** `PODIO_LIST_COMMENTS`

Page through comments on a Podio object such as an item or task.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of comments to return in this page. Defaults to 100. |
| `offset` | integer | No | Zero-based offset of the first comment to return. Pass next_offset from the previous response to continue. |
| `reference_id` | integer | Yes | ID of the Podio object whose comments to list. |
| `reference_type` | string | Yes | Podio reference type of the object whose comments to list, such as item or task. |

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

**Slug:** `PODIO_LIST_ITEMS`

Filter and page through items in one Podio app, returning item IDs, titles, fields, and match totals. Setting remember to true also persists the filter view in Podio.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of items to return in this page. Defaults to 30. |
| `app_id` | integer | Yes | Podio app ID whose items to return. |
| `offset` | integer | No | Zero-based index of the first item to return. Pass next_offset from the previous response to continue with the same filters and sorting. |
| `filters` | object | No | Map of Podio field or filter keys to their documented filter values. |
| `sort_by` | string | No | Field or documented sort key used to order the items. |
| `remember` | boolean | No | Whether Podio should remember this filter view. |
| `sort_desc` | boolean | No | Whether to sort the items in descending order. |

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

**Slug:** `PODIO_LIST_ORGANIZATIONS`

List organizations available to the connected user, including member spaces and access rights.

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

**Slug:** `PODIO_LIST_ORGANIZATION_WORKSPACES`

List Podio spaces in an organization that are accessible to the connected user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org_id` | integer | Yes | ID of the organization to inspect. |

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

**Slug:** `PODIO_LIST_SPACES`

List the spaces the connected user can access in a Podio organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org_id` | integer | Yes | Organization ID returned by List Organizations. |

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

**Slug:** `PODIO_LIST_TASK_LABELS`

List the connected user's personal Podio task labels.

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

**Slug:** `PODIO_LIST_TASKS`

Filter and page through Podio tasks visible to the connected user, including open or completed tasks and reference filters.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `app` | array | No | Application IDs used to filter tasks. |
| `org` | array | No | Organization IDs used to filter related tasks. |
| `view` | string | No | Set to full to request the full task representation. |
| `files` | boolean | No | True to require files on the task, false to require no files, or omit for no file restriction. |
| `label` | integer | No | ID of a label that returned tasks must have. |
| `limit` | integer | No | Maximum number of tasks to return in this page. |
| `space` | array | No | Space IDs used to filter related tasks. |
| `offset` | integer | No | Zero-based offset of the first task to return. Pass next_offset from the previous response to continue with the same filters. |
| `sort_by` | string ("created_on" | "completed_on" | "rank") | No | Field used to sort tasks. Defaults to rank. |
| `due_date` | string | No | Due-date range in YYYY-MM-DD-YYYY-MM-DD format. |
| `grouping` | string ("due_date" | "created_by" | "responsible" | "app" | "space" | "org") | No | Grouping to apply to the returned tasks. |
| `completed` | boolean | No | True to return only completed tasks; false to return only open tasks. |
| `reference` | string | No | References in "type:id" form separated by semicolons. |
| `sort_desc` | boolean | No | Whether to sort tasks in descending order. Defaults to false. |
| `created_by` | string | No | Entities that created the task, using Podio's auth-object filter syntax. |
| `created_on` | string | No | Creation date range in YYYY-MM-DD-YYYY-MM-DD format. |
| `reassigned` | boolean | No | True to return tasks the active user assigned to someone else; false to return tasks the active user did not assign to someone else. |
| `created_via` | integer | No | ID of the API client through which the task was created. |
| `external_id` | string | No | External ID of the task. |
| `responsible` | array | No | User IDs responsible for the returned tasks. |
| `completed_by` | string | No | Entities that completed the task, using Podio's auth-object filter syntax. |
| `completed_on` | string | No | Completion date range in YYYY-MM-DD-YYYY-MM-DD format, for example 2017-06-01-2017-06-30. |

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

### Rank Task

**Slug:** `PODIO_RANK_TASK`

Place a Podio task before or after other tasks in the task ranking.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `after` | integer | No | Task ID that this task should be placed after. |
| `before` | integer | No | Task ID that this task should be placed before. |
| `task_id` | integer | Yes | Podio task ID to rank. |

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

### Rearrange Item

**Slug:** `PODIO_REARRANGE_ITEM`

Apply documented from/to field-value changes and optional priority placement to a Podio item.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `values` | object | No | Optional field IDs mapped to from/to value changes. |
| `item_id` | integer | Yes | Podio item ID to rearrange. |
| `priority` | object | No | Optional above/below item IDs defining priority order. |

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

### Remove Task Reference

**Slug:** `PODIO_REMOVE_TASK_REFERENCE`

Remove the object reference from a Podio task.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `task_id` | integer | Yes | Podio task 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 |

### Replace Task Labels

**Slug:** `PODIO_REPLACE_TASK_LABELS`

Replace all labels on a Podio task using label IDs or label names.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `labels` | array | Yes | Complete replacement list of task label IDs or label names. |
| `task_id` | integer | Yes | Podio task ID to update. |

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

### Restore Space

**Slug:** `PODIO_RESTORE_SPACE`

Restore an archived Podio space, making it visible in navigation again.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `space_id` | integer | Yes | ID of the archived space to restore. |

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

### Revert Item Revision

**Slug:** `PODIO_REVERT_ITEM_REVISION`

Destructively undo the change made in one revision. This restores the prior values and overwrites any later changes made to the same fields.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `item_id` | integer | Yes | Podio item ID to modify. |
| `revision` | integer | Yes | Revision whose individual change should be undone. |

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

### Revert To Revision

**Slug:** `PODIO_REVERT_TO_REVISION`

Destructively restore an item to all values in the selected revision, undoing every change made after that revision.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `item_id` | integer | Yes | Podio item ID to restore. |
| `revision` | integer | Yes | Zero-based revision whose complete values should be restored. |

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

### Set Participation

**Slug:** `PODIO_SET_PARTICIPATION`

Set the connected user's participation status on a Podio item.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `status` | string ("invited" | "accepted" | "declined" | "tentative") | Yes | New participation status for the connected user. |
| `item_id` | integer | Yes | Podio item 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 |

### Set User Properties

**Slug:** `PODIO_SET_USER_PROPERTIES`

Set one or more auth-client-specific JSON object properties for the active Podio user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `properties` | object | Yes | Property names mapped to their JSON object values. |

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

### Set User Property

**Slug:** `PODIO_SET_USER_PROPERTY`

Set one auth-client-specific JSON object property for the active Podio user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Auth-client-specific user property name. |
| `value` | object | Yes | New JSON object value for the property. |

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

### Update an App Field

**Slug:** `PODIO_UPDATE_AN_APP_FIELD`

Update the configuration of one Podio app field.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `delta` | integer | No | New order of the field in the app. |
| `label` | string | No | New label displayed for the field. |
| `app_id` | integer | Yes | ID of the app containing the field. |
| `mapping` | string ("meeting_time" | "meeting_participants" | "meeting_agenda" | "meeting_location") | No | Meeting field mapping. |
| `field_id` | integer | Yes | ID of the field to update. |
| `required` | boolean | No | Whether the field is required on items. |
| `settings` | object | No | New settings specific to the field type. |
| `description` | string | No | New help text for the field. |
| `hidden_create_view_edit` | boolean | No | Whether the field is hidden in create, view, and edit mode. |

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

### Update App Description

**Slug:** `PODIO_UPDATE_APP_DESCRIPTION`

Update a Podio app's description.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `app_id` | integer | Yes | ID of the app to update. |
| `silent` | boolean | No | Whether to avoid stream bumps and notifications. Defaults to false. |
| `description` | string | Yes | Updated app description. |

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

### Update App Configuration and Fields

**Slug:** `PODIO_UPDATE_APP_EXPANDED`

Update a Podio app's configuration, fields, and field deletions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `app_id` | integer | Yes | ID of the app to update. |
| `config` | object | No | New app configuration, if changing it. |
| `fields` | array | No | New fields and configuration updates for existing fields. |
| `silent` | boolean | No | Whether to avoid stream bumps and notifications. Defaults to false. |
| `fields_to_delete` | array | No | Fields to delete as part of this update. |

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

### Update App Order

**Slug:** `PODIO_UPDATE_APP_ORDER`

Set the order of apps in a Podio space.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `app_ids` | array | Yes | App IDs in their new order. |
| `space_id` | integer | Yes | ID of the space containing the apps. |

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

### Update App Usage Instructions

**Slug:** `PODIO_UPDATE_APP_USAGE_INSTRUCTIONS`

Update a Podio app's usage instructions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `usage` | string | Yes | Updated usage instructions for the app. |
| `app_id` | integer | Yes | ID of the app to update. |
| `silent` | boolean | No | Whether to avoid stream bumps and notifications. Defaults to false. |

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

### Update App and Return App

**Slug:** `PODIO_UPDATE_APP_V2`

Update a Podio app's configuration and fields and return the app object.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `app_id` | integer | Yes | ID of the app to update. |
| `config` | object | No | New app configuration, if changing it. |
| `fields` | array | No | New fields and configuration updates for existing fields. |
| `silent` | boolean | No | Whether to avoid stream bumps and notifications. Defaults to false. |
| `fields_to_delete` | array | No | Fields to delete as part of this update. |

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

### Update Comment

**Slug:** `PODIO_UPDATE_COMMENT`

Replace a Podio comment's text, external ID, files, or embedded link. Omitting embed_id removes an existing embed, so resend its ID to preserve it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `value` | string | Yes | Replacement comment text. |
| `embed_id` | integer | No | Podio embed ID to attach. Omitting this field removes any existing embed; callers that need to preserve an embed must resend its ID. |
| `file_ids` | array | No | Replacement temporary uploaded file IDs to attach to the comment. |
| `embed_url` | string | No | Replacement URL to attach to the comment. |
| `comment_id` | integer | Yes | Podio comment ID returned by List Comments or Create Comment. |
| `external_id` | string | No | Replacement external-system identifier for the comment. |

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

### Update Item

**Slug:** `PODIO_UPDATE_ITEM`

Update one Podio item's fields or metadata, optionally using its revision for optimistic concurrency.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ref` | object | No | Replacement reference from the item to another Podio object. |
| `hook` | boolean | No | Whether Podio hooks should run for this change. Defaults to true. |
| `tags` | array | No | Complete list of tags for the item. |
| `fields` | object | No | Map of app field ID or external ID to the value shape required by that Podio field type. Use an empty array to delete all values for a field. |
| `silent` | boolean | No | Whether to avoid bumping the item in the stream and generating notifications. Defaults to false. |
| `item_id` | integer | Yes | Podio item ID to update. |
| `file_ids` | array | No | Complete list of file attachment IDs for the item. |
| `reminder` | object | No | Replacement reminder configuration for the item. |
| `revision` | integer | No | Current item revision used for optimistic concurrency control. |
| `recurrence` | object | No | Replacement recurrence configuration for the item. |
| `external_id` | string | No | Replacement external-system identifier for the item. |
| `linked_account_id` | integer | No | Linked account ID to use for a meeting item. |

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

### Update Item Field Values

**Slug:** `PODIO_UPDATE_ITEM_FIELD_VALUES`

Replace the values of one Podio item field selected by numeric ID or external ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `hook` | boolean | No | Whether Podio hooks should run. |
| `silent` | boolean | No | Whether to suppress stream bumps and notifications. |
| `values` | string | Yes | Complete replacement value in the shape required by the field type; arrays are sent as arrays, not wrapped. |
| `item_id` | integer | Yes | Podio item ID to update. |
| `field_or_external_id` | string | Yes | Numeric field ID or field external 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 |

### Update Item Values

**Slug:** `PODIO_UPDATE_ITEM_VALUES`

Replace values for multiple fields on a Podio item using field IDs or external IDs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `hook` | boolean | No | Whether Podio hooks should run. |
| `fields` | object | Yes | Field IDs or external IDs mapped to complete replacement values. |
| `silent` | boolean | No | Whether to suppress stream bumps and notifications. |
| `item_id` | integer | Yes | Podio item ID to update. |

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

### Update Notification Setting

**Slug:** `PODIO_UPDATE_NOTIFICATION_SETTING`

Enable or disable one Podio notification type for an email or mobile client.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `value` | boolean | Yes | Whether this notification type should be enabled. |
| `client_type` | string ("email" | "mobile") | Yes | Podio notification client type. |
| `notification_type` | string ("digest" | "bulletin" | "reference" | "message" | "space" | "subscription" | "user" | "reminder" | "push_notification" | "push_notification_sound" | "push_notification_browser") | Yes | Podio notification type. |

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

### Update Notification Settings

**Slug:** `PODIO_UPDATE_NOTIFICATION_SETTINGS`

Update multiple Podio notification-type settings for an email or mobile client.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `settings` | object | Yes | Notification types mapped to whether each type should be enabled. |
| `client_type` | string ("email" | "mobile") | Yes | Podio notification client type. |

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

### Update Organization

**Slug:** `PODIO_UPDATE_ORGANIZATION`

Administratively update a Podio organization's name, URL subdomain, or logo. Changing the name alone does not change its URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `logo` | integer | No | New organization logo file ID. |
| `name` | string | No | New organization name. Changing it does not change the organization URL. |
| `org_id` | integer | Yes | Podio organization ID to update. |
| `url_label` | string | No | New URL subdomain; defaults to the existing URL label when omitted. |

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

### Update Organization App Store Profile

**Slug:** `PODIO_UPDATE_ORGANIZATION_APP_STORE_PROFILE`

Administratively replace fields on an existing Podio organization app-store profile.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `fields` | object | Yes | App-store profile fields using Podio contact-area field names and values. These are sent as the top-level request body. |
| `org_id` | integer | Yes | Podio organization 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 |

### Update Profile

**Slug:** `PODIO_UPDATE_PROFILE`

Update selected contact-area fields on the active Podio user's profile; omitted fields remain unchanged.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `fields` | object | Yes | Profile field names mapped to replacement values or lists of values. Use null to delete a field. |

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

### Update Profile Field

**Slug:** `PODIO_UPDATE_PROFILE_FIELD`

Update one contact-area field on the active Podio user's profile.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `key` | string | Yes | Podio contact-area key of the active user's profile field. |
| `value` | string | Yes | Replacement value for the profile field. |

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

### Update Space

**Slug:** `PODIO_UPDATE_SPACE`

Update a Podio space's name, privacy, automatic joining, URL label, or announcement settings.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | New name of the space. |
| `privacy` | string ("open" | "closed") | No | New privacy level of the space. |
| `space_id` | integer | Yes | ID of the space to update. |
| `auto_join` | boolean | No | Whether new employees should be joined automatically. |
| `url_label` | string | No | New URL label of the space. |
| `post_on_new_app` | boolean | No | Whether new apps should be announced with a status update. |
| `post_on_new_member` | boolean | No | Whether new members should be announced with a status update. |

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

### Update Task

**Slug:** `PODIO_UPDATE_TASK`

Update a Podio task's full attributes, including completing or reopening it. COMPLETE_TASK and INCOMPLETE_TASK remain convenient dedicated state actions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `hook` | boolean | No | Whether Podio hooks should run for this change. |
| `text` | string | No | Replacement task title. |
| `labels` | array | No | Replacement labels as label IDs or label texts. |
| `ref_id` | integer | No | Replacement reference ID; provide together with ref_type. |
| `silent` | boolean | No | Whether to avoid bumping the task in the stream and generating notifications. |
| `private` | boolean | No | Whether the task is private. |
| `task_id` | integer | Yes | Podio task ID to update. |
| `due_date` | string | No | Replacement due date in the user's timezone, formatted YYYY-MM-DD. |
| `due_time` | string | No | Replacement due time in the user's timezone. |
| `file_ids` | array | No | Replacement list of attached file IDs. |
| `ref_type` | string | No | Replacement reference type; provide together with ref_id. |
| `reminder` | object | No | Replacement reminder. Set remind_delta to null to remove it. |
| `completed` | boolean | No | Whether the task is completed; false reopens a completed task. |
| `description` | string | No | Replacement task description. |
| `responsible` | integer | No | User ID newly responsible for the task. |

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

### Update Task Description

**Slug:** `PODIO_UPDATE_TASK_DESCRIPTION`

Replace only the description of a Podio task.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `hook` | boolean | No | Whether Podio hooks should run for this change. |
| `silent` | boolean | No | Whether to suppress stream bumps and notifications. |
| `task_id` | integer | Yes | Podio task ID to update. |
| `description` | string | Yes | New task description. |

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

### Update Task Due Date

**Slug:** `PODIO_UPDATE_TASK_DUE`

Update only the UTC or local due fields of a Podio task.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `hook` | boolean | No | Whether Podio hooks should run for this change. |
| `due_on` | string | No | New UTC due date and time. |
| `silent` | boolean | No | Whether to suppress stream bumps and notifications. |
| `task_id` | integer | Yes | Podio task ID to update. |
| `due_date` | string | No | New local due date. |
| `due_time` | string | No | New local due time. |

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

### Update Task Label

**Slug:** `PODIO_UPDATE_TASK_LABEL`

Replace the name and color of a personal Podio task label.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `text` | string | Yes | New name of the task label. |
| `color` | string | Yes | New six-character hexadecimal color without a leading hash. |
| `label_id` | integer | Yes | Podio task label ID to update. |

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

### Update Task Privacy

**Slug:** `PODIO_UPDATE_TASK_PRIVATE`

Update only whether a Podio task is private.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `hook` | boolean | No | Whether Podio hooks should run for this change. |
| `silent` | boolean | No | Whether to suppress stream bumps and notifications. |
| `private` | boolean | Yes | Whether the task should be private. |
| `task_id` | integer | Yes | Podio task ID to update. |

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

### Update Task Reference

**Slug:** `PODIO_UPDATE_TASK_REFERENCE`

Replace the object reference on a Podio task.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `hook` | boolean | No | Whether Podio hooks should run for this change. |
| `ref_id` | integer | Yes | ID of the new referenced Podio object. |
| `silent` | boolean | No | Whether to suppress stream bumps and notifications. |
| `task_id` | integer | Yes | Podio task ID to update. |
| `ref_type` | string | Yes | New Podio reference type. |

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

### Update Task Text

**Slug:** `PODIO_UPDATE_TASK_TEXT`

Replace only the text of a Podio task.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `hook` | boolean | No | Whether Podio hooks should run for this change. |
| `text` | string | Yes | New task text. |
| `silent` | boolean | No | Whether to suppress stream bumps and notifications. |
| `task_id` | integer | Yes | Podio task ID to update. |

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