Checking authentication...

Sharing

Share items with users -- grant, update, revoke, or list per-user access

4 tools

Share Item

Read

POST /v1/tools/podio/shareItem

Share a Podio item with one or more people by granting access. Recipients can be specified as Podio user IDs, profile IDs, or email addresses (external users get an invitation). Set access_level to "view" (read-only) or "edit". Optionally include a message with the invitation. Use podio_getItemShares first to see who already has access. If a person already has a grant, use podio_updateShare instead.

Parameters

Name	Type	Required	Description
`item_id`	number	required	Item ID to share (from filterItems, getItem, or platform context).
`access_level`	string	required	"view" (read-only) or "edit" (full edit access). Values: view, edit
`user_ids`	array	optional	Podio user IDs of existing users to share with.
`profile_ids`	array	optional	Podio profile IDs (contacts) to share with.
`emails`	array	optional	Email addresses to share with. Podio sends an invitation if the email is not a Podio user.
`message`	string	optional	Optional message included in the share notification/invitation.

Request

curl -X POST https://api.syncello.io/v1/tools/podio/shareItem \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "item_id": "123",
  "access_level": "view"
}'

Response

{
  "invitable": []
}

Try It

Try it

Update Share

Write Idempotent

POST /v1/tools/podio/updateShare

Change a user's access level on a shared Podio item. Use this when a person already has a grant (podio_getItemShares lists current grants). access_level must be "view" or "edit". To create a new grant for someone who doesn't yet have access, use podio_shareItem. To revoke access entirely, use podio_deleteShare.

Parameters

Name	Type	Required	Description
`item_id`	number	required	Item ID whose share is being updated.
`user_id`	number	required	The user ID whose access level to change.
`access_level`	string	required	New access level: "view" or "edit". Values: view, edit

Request

curl -X POST https://api.syncello.io/v1/tools/podio/updateShare \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "item_id": "123",
  "user_id": "123",
  "access_level": "view"
}'

Response

{
  "success": true,
  "item_id": 3141592653,
  "user_id": 1122334,
  "access_level": "edit"
}

Try It

Try it

Delete Share

Destructive Idempotent

POST /v1/tools/podio/deleteShare

Revoke a user's access to a shared Podio item. Removes one user's grant at a time by design -- there is no bulk delete. Use podio_getItemShares first to confirm the user currently has a grant.

Parameters

Name	Type	Required	Description
`item_id`	number	required	Item ID whose share is being revoked.
`user_id`	number	required	User ID whose access to revoke.

Request

curl -X POST https://api.syncello.io/v1/tools/podio/deleteShare \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "item_id": "123",
  "user_id": "123"
}'

Response

{
  "item_id": 3141592653,
  "user_id": 1122334
}

Try It

Try it

Get Item Shares

Read Idempotent

POST /v1/tools/podio/getItemShares

List all users who currently have access to a Podio item. Returns each grant with grant_id, the user profile, and their access_level. Use this to answer "who has access to this item?" or before calling podio_updateShare / podio_deleteShare to verify a user has an existing grant.

Parameters

Name	Type	Required	Description
`item_id`	number	required	Item ID to list shares for.

Request

curl -X POST https://api.syncello.io/v1/tools/podio/getItemShares \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "item_id": "123"
}'

Response

[
  {
    "grant_id": 90010011,
    "access_level": "view",
    "created_on": "2026-07-01 14:42:32",
    "rights": [
      "view",
      "delete"
    ],
    "user": {
      "user_id": 1122334,
      "profile_id": 4455667,
      "name": "Jane Doe",
      "type": "user"
    }
  }
]