API reference

Members

A workspace's members and invitations.

GET/members

List members

Permission: readGuests too

Parameters

NameTypeRequiredDescription
afterquerystringOptionalCursor: nextAfter of the previous page.
limitquerystringOptionalPage size (1-500).
Pluto-Workspaceheaderstring (uuid)OptionalThe workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403.

Response200 OK

itemsarray of objectsRequired
This page.
items[].accessRoleobject or null
The narrower role a member holds; null for a tier's own role (a member without one is a Manager).
items[].accessRole.idstring
A built-in role's key (media_buyer, …) or a custom role's ID.
items[].accessRole.namestring
Its name.
items[].addedAtstring (date-time)
Joined.
items[].assignedCountinteger
Ads assigned in unarchived launches.
items[].avatarUrlstring or null
Avatar.
items[].emailstring
Email; omitted when a guest lists the members.
items[].namestringRequired
Name.
items[].rolestringRequired
Membership tier (seats follow it).One of owner, admin, member, guest
items[].seatboolean
A paid seat of the organization (any role but guest in one of its workspaces). Making a guest a member or admin adds one; making someone a guest everywhere frees it.
items[].statusstringRequired
Status.One of active, suspended
items[].userIdstring (uuid)Required
Person.
items[].versionintegerRequired
Version.
nextAfterstring or integer or null
Cursor for the next page; null at the end.

Errors

  • 400The request is malformed.
  • 401No valid credential.
  • 403The credential lacks the permission, or belongs to another workspace.
  • 429Too many requests from this credential. Wait Retry-After seconds. People in the app have their own budget, so an agent swarm can't starve them.
curl "$PLUTO_API/members" \
  -H "Authorization: Bearer $PLUTO_KEY"
GET/members/invitations

List invitations

Empty for guests: invitations name people by email.

Permission: readGuests too

Parameters

NameTypeRequiredDescription
statusquerystringOptionalpending (default) or all.
afterquerystringOptionalCursor.
limitquerystringOptionalPage size.
Pluto-Workspaceheaderstring (uuid)OptionalThe workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403.

Response200 OK

itemsarray of objectsRequired
This page.
items[].accessRoleobject or null
The narrower role it grants (id: a built-in role's key or a custom role's ID; name); null for a tier's own role.
items[].createdAtstring (date-time)
Sent.
items[].emailstringRequired
Email.
items[].expiresAtstring (date-time)Required
Expiry.
items[].idstring (uuid)Required
Invitation.
items[].invitedBystring (uuid) or null
Who invited, or sent it again last: a person, or the person behind the API key or agent that did.
items[].invitedByNamestring or null
Their name.
items[].namestringRequired
Name.
items[].rolestringRequired
Membership tier it grants.One of owner, admin, member, guest
items[].statusstringRequired
Status; a pending invitation past expiresAt reads as expired.One of pending, accepted, revoked, expired
nextAfterstring or integer or null
Cursor for the next page; null at the end.

Errors

  • 400The request is malformed.
  • 401No valid credential.
  • 403The credential lacks the permission, or belongs to another workspace.
  • 429Too many requests from this credential. Wait Retry-After seconds. People in the app have their own budget, so an agent swarm can't starve them.
curl "$PLUTO_API/members/invitations" \
  -H "Authorization: Bearer $PLUTO_KEY"
POST/members/invitations

Invite someone by email

Permission: adminCommand: send Idempotency-Key

Parameters

NameTypeRequiredDescription
Idempotency-KeyheaderstringOptionalThe command ID. A retry with the same key returns the stored result; the same key with different input is a 409. Without it a retry cannot be recognized.
Pluto-Workspaceheaderstring (uuid)OptionalThe workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403.

Request body

emailstringRequired
Email.
namestringRequired
Name.
rolestringRequired
Role on joining: a tier (owner, admin, member, guest), a built-in role (manager, the same as member; media_buyer, creative, analyst) or a custom workspace role's ID, never beyond the caller's own access. A guest reads, comments and approves or requests changes; guests are free.

Response201 Created

accessRoleobject or null
The narrower role it grants (id: a built-in role's key or a custom role's ID; name); null for a tier's own role.
createdAtstring (date-time)
Sent.
emailstringRequired
Email.
expiresAtstring (date-time)Required
Expiry.
idstring (uuid)Required
Invitation.
invitedBystring (uuid) or null
Who invited, or sent it again last: a person, or the person behind the API key or agent that did.
invitedByNamestring or null
Their name.
namestringRequired
Name.
rolestringRequired
Membership tier it grants.One of owner, admin, member, guest
statusstringRequired
Status; a pending invitation past expiresAt reads as expired.One of pending, accepted, revoked, expired

Errors

  • 400The request is malformed.
  • 401No valid credential.
  • 403The credential lacks the permission, or belongs to another workspace.
  • 409Conflict: a stale expectedVersion (the body carries current), a duplicate, or an Idempotency-Key reused with different input.
  • 422Validation failed; errors lists every field problem at once.
  • 429Too many requests from this credential. Wait Retry-After seconds. People in the app have their own budget, so an agent swarm can't starve them.
curl -X POST "$PLUTO_API/members/invitations" \
  -H "Authorization: Bearer $PLUTO_KEY" \
  -H "Idempotency-Key: 8fb769d8-3f53-406d-a55b-dab17c78323f" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "maya@brevanne.com",
    "name": "Maya Patel",
    "role": "owner"
  }'
POST/members/invitations/{id}/revoke

Revoke an invitation

Permission: adminCommand: send Idempotency-Key

Parameters

NameTypeRequiredDescription
idpathstringRequiredThe invitation's ID.
Idempotency-KeyheaderstringOptionalThe command ID. A retry with the same key returns the stored result; the same key with different input is a 409. Without it a retry cannot be recognized.
Pluto-Workspaceheaderstring (uuid)OptionalThe workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403.

Response200 OK

accessRoleobject or null
The narrower role it grants (id: a built-in role's key or a custom role's ID; name); null for a tier's own role.
createdAtstring (date-time)
Sent.
emailstringRequired
Email.
expiresAtstring (date-time)Required
Expiry.
idstring (uuid)Required
Invitation.
invitedBystring (uuid) or null
Who invited, or sent it again last: a person, or the person behind the API key or agent that did.
invitedByNamestring or null
Their name.
namestringRequired
Name.
rolestringRequired
Membership tier it grants.One of owner, admin, member, guest
statusstringRequired
Status; a pending invitation past expiresAt reads as expired.One of pending, accepted, revoked, expired

Errors

  • 400The request is malformed.
  • 401No valid credential.
  • 403The credential lacks the permission, or belongs to another workspace.
  • 404Not found in this workspace.
  • 409Conflict: a stale expectedVersion (the body carries current), a duplicate, or an Idempotency-Key reused with different input.
  • 422Validation failed; errors lists every field problem at once.
  • 429Too many requests from this credential. Wait Retry-After seconds. People in the app have their own budget, so an agent swarm can't starve them.
curl -X POST "$PLUTO_API/members/invitations/44dd6197-d0a8-4cd3-bd03-3e59b3a51fa7/revoke" \
  -H "Authorization: Bearer $PLUTO_KEY" \
  -H "Idempotency-Key: f91460e4-e72e-4612-aa3a-5bfcbb6e5a8a"
PATCH/members/{user_id}

Change a member's role

Permission: adminCommand: send Idempotency-Key

Parameters

NameTypeRequiredDescription
user_idpathstringRequiredThe user's ID.
Idempotency-KeyheaderstringOptionalThe command ID. A retry with the same key returns the stored result; the same key with different input is a 409. Without it a retry cannot be recognized.
Pluto-Workspaceheaderstring (uuid)OptionalThe workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403.

Request body

expectedVersioninteger
The version you last read. A mismatch is a conflict that returns the current entity.
rolestringRequired
New role: a tier (owner, admin, member, guest), a built-in role (manager, the same as member; media_buyer, creative, analyst) or a custom workspace role's ID (GET /access/roles). A guest reads, comments and approves or requests changes; guests are free. Never beyond the caller's own access: 403 names the missing capability.

Response200 OK

accessRoleobject or null
The narrower role a member holds; null for a tier's own role (a member without one is a Manager).
accessRole.idstring
A built-in role's key (media_buyer, …) or a custom role's ID.
accessRole.namestring
Its name.
addedAtstring (date-time)
Joined.
assignedCountinteger
Ads assigned in unarchived launches.
avatarUrlstring or null
Avatar.
emailstring
Email; omitted when a guest lists the members.
namestringRequired
Name.
rolestringRequired
Membership tier (seats follow it).One of owner, admin, member, guest
seatboolean
A paid seat of the organization (any role but guest in one of its workspaces). Making a guest a member or admin adds one; making someone a guest everywhere frees it.
statusstringRequired
Status.One of active, suspended
userIdstring (uuid)Required
Person.
versionintegerRequired
Version.

Errors

  • 400The request is malformed.
  • 401No valid credential.
  • 403The credential lacks the permission, or belongs to another workspace.
  • 404Not found in this workspace.
  • 409Conflict: a stale expectedVersion (the body carries current), a duplicate, or an Idempotency-Key reused with different input.
  • 422Validation failed; errors lists every field problem at once.
  • 429Too many requests from this credential. Wait Retry-After seconds. People in the app have their own budget, so an agent swarm can't starve them.
curl -X PATCH "$PLUTO_API/members/66edca53-0813-467f-bdb8-313e9ad9882f" \
  -H "Authorization: Bearer $PLUTO_KEY" \
  -H "Idempotency-Key: d4cffbe4-3820-486c-9cad-a8d960ad2c2f" \
  -H "Content-Type: application/json" \
  -d '{
    "expectedVersion": 3,
    "role": "owner"
  }'
DELETE/members/{user_id}

Remove a member, or leave the workspace

Removing someone else needs admin (an owner to remove an owner). Anyone can remove themselves to leave the workspace, unless they are its last owner. Their past work, comments and assignments stay. Their connected agents and Pluto MCP connections here are revoked and the webhooks they set up here are turned off. Their API keys and agent clients here are revoked, or with credentials=hand_over_to_me each API key and service agent client here is re-issued to you where you may hold it (you manage credentials here and hold its scopes): a new secret shown once in this answer, an agent client also a new clientId, and the old one stops at once with what it made. The rest are revoked, each with why. Never for yourself (422), nor while the organization's credential policy keeps handing over off (403). Without credentials the answer is 204.

Permission: adminCommand: send Idempotency-Key

Parameters

NameTypeRequiredDescription
user_idpathstringRequiredThe user's ID.
credentialsquerystringOptionalrevoke (the default) or hand_over_to_me. Sent, the answer is 200 with handedOver and revoked.
Idempotency-KeyheaderstringOptionalThe command ID. A retry with the same key returns the stored result; the same key with different input is a 409. Without it a retry cannot be recognized.
Pluto-Workspaceheaderstring (uuid)OptionalThe workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403.

Response200 OK

handedOverarray of objectsRequired
Re-issued to you, each with its new secret in this answer only (an agent client with its new clientId too); empty unless you chose hand_over_to_me.
handedOver[].allowedIpsarray of strings or null
The addresses or ranges (address/length) it works from (keys and agent clients); null: anywhere.
handedOver[].clientIdstring
An agent client's new OAuth client ID; absent for an API key.
handedOver[].createdAtstring (date-time)Required
Created.
handedOver[].createdByActorobject or null
Who made it (kind, id, name: a person, an API key or an agent); null for a person's own agent.
handedOver[].deliveringboolean
A webhook's: whether events go out to it now, only while the person accountable for it may manage webhooks in its workspace. Absent for every other kind.
handedOver[].detailstringRequired
Key kind, client kind or how the agent connected.One of secret, publishable, m2m, mcp, connection, registration, webhook, pluto_mcp
handedOver[].expiresAtstring (date-time) or null
When it stops working by itself; null: never.
handedOver[].idstring (uuid)Required
Credential ID.
handedOver[].kindstringRequired
What it is: a webhook or a Pluto MCP connection only in the organization's list.One of api_key, agent_client, agent_connection, webhook, pluto_mcp
handedOver[].lastUsedAtstring (date-time) or null
Last use.
handedOver[].lastUsedIpstring or null
The address of its last use.
handedOver[].namestringRequired
Name.
handedOver[].notDeliveringobject
A webhook's: why it doesn't deliver now (reason: role, no_access, credential_ended or nobody; userId, userName, message). Absent while it delivers and for every other kind.
handedOver[].replacesstring (uuid)Required
The credential it replaces, now revoked.
handedOver[].resourcesobject
What it reaches in the workspace.
handedOver[].resources.adAccountsstring or array of objectsRequired
all: every ad account of the workspace. Otherwise the ad accounts it reaches; what's in another one is invisible to it and refused to it.
handedOver[].scopesarray of stringsRequired
Scopes; never more than the person's current role.
handedOver[].secretstring or null
The new secret: in the first response only, never in a replay.
handedOver[].userEmailstring or null
Their email.
handedOver[].userIdstring (uuid) or null
The person it acts for (a key's or M2M client's owner, the person accountable for a webhook).
handedOver[].userNamestring or null
Their name.
handedOver[].workspaceIdstring (uuid)Required
The workspace it works in.
handedOver[].workspaceNamestringRequired
Its name.
revokedarray of objectsRequired
Revoked with their access; when you chose hand_over_to_me, each with why it wasn't handed over.
revoked[].detailstringRequired
Key kind, or client kind: m2m a service, mcp an agent acting for them.One of secret, publishable, m2m, mcp
revoked[].idstring (uuid)Required
Credential ID.
revoked[].kindstringRequired
What it is.One of api_key, agent_client
revoked[].messagestring or nullRequired
reason in one sentence.
revoked[].namestringRequired
Name.
revoked[].reasonstring or nullRequired
Why it isn't handed over, when that was asked: it's their own agent (own_agent), you don't manage credentials in its workspace (manage), it holds access you don't have there (scopes), your organization doesn't let you have agents (agents), it's the credential making the request (in_use), or it changed while they were being removed (changed). Null otherwise.One of own_agent, manage, scopes, agents, in_use, changed
revoked[].workspaceIdstring (uuid)Required
The workspace it works in.
revoked[].workspaceNamestringRequired
Its name.

Errors

  • 400The request is malformed.
  • 401No valid credential.
  • 403The credential lacks the permission, or belongs to another workspace.
  • 404Not found in this workspace.
  • 409Conflict: a stale expectedVersion (the body carries current), a duplicate, or an Idempotency-Key reused with different input.
  • 422Validation failed; errors lists every field problem at once.
  • 429Too many requests from this credential. Wait Retry-After seconds. People in the app have their own budget, so an agent swarm can't starve them.
curl -X DELETE "$PLUTO_API/members/66edca53-0813-467f-bdb8-313e9ad9882f" \
  -H "Authorization: Bearer $PLUTO_KEY" \
  -H "Idempotency-Key: a24e626c-e30d-4228-b8f1-79b8954384ae"
GET/members/{user_id}/offboarding

Preview removing a member

Whoever may remove people from the workspace, and the person themselves before leaving it. What they own here, as the organization's preview says it for the whole organization: their loops, Agent chats, API keys, agent clients, connected agents, Pluto MCP connections and webhooks in this workspace, and handOver: whether you may remove them with credentials=hand_over_to_me, what that would re-issue to you and what it would revoke instead, each with why.

Permission: admin

Parameters

NameTypeRequiredDescription
user_idpathstringRequiredThe user's ID.
Pluto-Workspaceheaderstring (uuid)OptionalThe workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403.

Response200 OK

agentClientsarray of objectsRequired
Agent clients they made or that act for them.
agentClients[].idstring (uuid)Required
Credential ID.
agentClients[].namestringRequired
Name.
agentClients[].workspaceIdstring (uuid)Required
The workspace it works in.
agentClients[].workspaceNamestringRequired
Its name.
agentConnectionsarray of objectsRequired
Agents they connected.
agentConnections[].idstring (uuid)Required
Credential ID.
agentConnections[].namestringRequired
Name.
agentConnections[].workspaceIdstring (uuid)Required
The workspace it works in.
agentConnections[].workspaceNamestringRequired
Its name.
apiKeysarray of objectsRequired
API keys they made.
apiKeys[].idstring (uuid)Required
Credential ID.
apiKeys[].namestringRequired
Name.
apiKeys[].workspaceIdstring (uuid)Required
The workspace it works in.
apiKeys[].workspaceNamestringRequired
Its name.
chatsintegerRequired
Their Agent chats in the organization.
handOverobjectRequired
handOver.availablebooleanRequired
You may remove them with credentials=hand_over_to_me.
handOver.handedOverarray of objectsRequired
What would be re-issued to you.
handOver.handedOver[].detailstringRequired
Key kind, or client kind: m2m a service, mcp an agent acting for them.One of secret, publishable, m2m, mcp
handOver.handedOver[].idstring (uuid)Required
Credential ID.
handOver.handedOver[].kindstringRequired
What it is.One of api_key, agent_client
handOver.handedOver[].messagestring or nullRequired
reason in one sentence.
handOver.handedOver[].namestringRequired
Name.
handOver.handedOver[].reasonstring or nullRequired
Why it isn't handed over, when that was asked: it's their own agent (own_agent), you don't manage credentials in its workspace (manage), it holds access you don't have there (scopes), your organization doesn't let you have agents (agents), it's the credential making the request (in_use), or it changed while they were being removed (changed). Null otherwise.One of own_agent, manage, scopes, agents, in_use, changed
handOver.handedOver[].workspaceIdstring (uuid)Required
The workspace it works in.
handOver.handedOver[].workspaceNamestringRequired
Its name.
handOver.messagestring or nullRequired
unavailable in one sentence.
handOver.revokedarray of objectsRequired
What would be revoked instead, each with why.
handOver.revoked[].detailstringRequired
Key kind, or client kind: m2m a service, mcp an agent acting for them.One of secret, publishable, m2m, mcp
handOver.revoked[].idstring (uuid)Required
Credential ID.
handOver.revoked[].kindstringRequired
What it is.One of api_key, agent_client
handOver.revoked[].messagestring or nullRequired
reason in one sentence.
handOver.revoked[].namestringRequired
Name.
handOver.revoked[].reasonstring or nullRequired
Why it isn't handed over, when that was asked: it's their own agent (own_agent), you don't manage credentials in its workspace (manage), it holds access you don't have there (scopes), your organization doesn't let you have agents (agents), it's the credential making the request (in_use), or it changed while they were being removed (changed). Null otherwise.One of own_agent, manage, scopes, agents, in_use, changed
handOver.revoked[].workspaceIdstring (uuid)Required
The workspace it works in.
handOver.revoked[].workspaceNamestringRequired
Its name.
handOver.unavailablestring or nullRequired
Why not: the organization's credential policy keeps handing over off (policy), it's you leaving (yourself), or nobody is accountable for the credential asking (no_person). Null when it's available.One of policy, yourself, no_person
loopsarray of objectsRequired
Loops they own, archived ones aside.
loops[].idstring (uuid)Required
Loop ID.
loops[].namestringRequired
Name.
loops[].statusstringRequired
Status.One of draft, active, paused
loops[].workspaceIdstring (uuid)Required
Workspace.
loops[].workspaceNamestringRequired
Its name.
plutoMcparray of objectsRequired
Their Pluto MCP connections.
plutoMcp[].idstring (uuid)Required
Credential ID.
plutoMcp[].namestringRequired
Name.
plutoMcp[].workspaceIdstring (uuid)Required
The workspace it works in.
plutoMcp[].workspaceNamestringRequired
Its name.
webhooksarray of objectsRequired
Webhooks they set up, or a credential of theirs did.
webhooks[].idstring (uuid)Required
Webhook ID.
webhooks[].urlstringRequired
Its endpoint.
webhooks[].workspaceIdstring (uuid)Required
The workspace it works in.
webhooks[].workspaceNamestringRequired
Its name.

Errors

  • 400The request is malformed.
  • 401No valid credential.
  • 403The credential lacks the permission, or belongs to another workspace.
  • 404Not found in this workspace.
  • 429Too many requests from this credential. Wait Retry-After seconds. People in the app have their own budget, so an agent swarm can't starve them.
curl "$PLUTO_API/members/66edca53-0813-467f-bdb8-313e9ad9882f/offboarding" \
  -H "Authorization: Bearer $PLUTO_KEY"
POST/members/{user_id}/reactivate

Reactivate a member

Permission: adminCommand: send Idempotency-Key

Parameters

NameTypeRequiredDescription
user_idpathstringRequiredThe user's ID.
Idempotency-KeyheaderstringOptionalThe command ID. A retry with the same key returns the stored result; the same key with different input is a 409. Without it a retry cannot be recognized.
Pluto-Workspaceheaderstring (uuid)OptionalThe workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403.

Response200 OK

accessRoleobject or null
The narrower role a member holds; null for a tier's own role (a member without one is a Manager).
accessRole.idstring
A built-in role's key (media_buyer, …) or a custom role's ID.
accessRole.namestring
Its name.
addedAtstring (date-time)
Joined.
assignedCountinteger
Ads assigned in unarchived launches.
avatarUrlstring or null
Avatar.
emailstring
Email; omitted when a guest lists the members.
namestringRequired
Name.
rolestringRequired
Membership tier (seats follow it).One of owner, admin, member, guest
seatboolean
A paid seat of the organization (any role but guest in one of its workspaces). Making a guest a member or admin adds one; making someone a guest everywhere frees it.
statusstringRequired
Status.One of active, suspended
userIdstring (uuid)Required
Person.
versionintegerRequired
Version.

Errors

  • 400The request is malformed.
  • 401No valid credential.
  • 403The credential lacks the permission, or belongs to another workspace.
  • 404Not found in this workspace.
  • 409Conflict: a stale expectedVersion (the body carries current), a duplicate, or an Idempotency-Key reused with different input.
  • 422Validation failed; errors lists every field problem at once.
  • 429Too many requests from this credential. Wait Retry-After seconds. People in the app have their own budget, so an agent swarm can't starve them.
curl -X POST "$PLUTO_API/members/66edca53-0813-467f-bdb8-313e9ad9882f/reactivate" \
  -H "Authorization: Bearer $PLUTO_KEY" \
  -H "Idempotency-Key: ce23663d-c0a5-4e92-a87d-ca592aa1dec1"
POST/members/{user_id}/suspend

Suspend a member (and their agents)

Permission: adminCommand: send Idempotency-Key

Parameters

NameTypeRequiredDescription
user_idpathstringRequiredThe user's ID.
Idempotency-KeyheaderstringOptionalThe command ID. A retry with the same key returns the stored result; the same key with different input is a 409. Without it a retry cannot be recognized.
Pluto-Workspaceheaderstring (uuid)OptionalThe workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403.

Response200 OK

accessRoleobject or null
The narrower role a member holds; null for a tier's own role (a member without one is a Manager).
accessRole.idstring
A built-in role's key (media_buyer, …) or a custom role's ID.
accessRole.namestring
Its name.
addedAtstring (date-time)
Joined.
assignedCountinteger
Ads assigned in unarchived launches.
avatarUrlstring or null
Avatar.
emailstring
Email; omitted when a guest lists the members.
namestringRequired
Name.
rolestringRequired
Membership tier (seats follow it).One of owner, admin, member, guest
seatboolean
A paid seat of the organization (any role but guest in one of its workspaces). Making a guest a member or admin adds one; making someone a guest everywhere frees it.
statusstringRequired
Status.One of active, suspended
userIdstring (uuid)Required
Person.
versionintegerRequired
Version.

Errors

  • 400The request is malformed.
  • 401No valid credential.
  • 403The credential lacks the permission, or belongs to another workspace.
  • 404Not found in this workspace.
  • 409Conflict: a stale expectedVersion (the body carries current), a duplicate, or an Idempotency-Key reused with different input.
  • 422Validation failed; errors lists every field problem at once.
  • 429Too many requests from this credential. Wait Retry-After seconds. People in the app have their own budget, so an agent swarm can't starve them.
curl -X POST "$PLUTO_API/members/66edca53-0813-467f-bdb8-313e9ad9882f/suspend" \
  -H "Authorization: Bearer $PLUTO_KEY" \
  -H "Idempotency-Key: 18c47d15-933b-4e0e-a334-8b6231c382e7"