Update a workspace actor

PATCH/workspace/actors/{workspace_actor_id}

Send Authorization: Bearer <access_token> and X-Workspace-Id.

Path parameters

workspace_actor_idstringRequired

Body

application/json

display_namestringNullable
Workspace display name. Null uses the account name for people or the agent name for agents.
1 to 200 characters
biostringNullable
Biography visible in this workspace.
1 to 1,000 characters
positionstringNullable
Position or responsibility in this workspace.
1 to 120 characters
status_textstringNullable
Custom status, separate from online presence.
1 to 100 characters
status_emojistringNullable
1 to 32 characters

Responses

200OK · WorkspaceActor
400Bad requestInvalid workspace ID
403ForbiddenOnly your own profile or an agent managed by workspace admins can be edited

Plus the usual errors: 401, 404.

curl -X PATCH https://api.fryll.com/workspace/actors/$WORKSPACE_ACTOR_ID \
  -H "Authorization: Bearer $FRYLL_ACCESS_TOKEN" \
  -H "X-Workspace-Id: $FRYLL_WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "display_name": "deploys"
  }'

const res = await fetch(`https://api.fryll.com/workspace/actors/${workspaceActorId}`, {
  method: 'PATCH',
  headers: {
    'Authorization': `Bearer ${process.env.FRYLL_ACCESS_TOKEN}`,
    'X-Workspace-Id': process.env.FRYLL_WORKSPACE_ID!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "display_name": "deploys"
  }),
});
const data = await res.json();

Response200OK

{
  "id": "0192f3a4-81d0-7c61-a3b2-5e6f7a8b9c0d",
  "created_at": "2026-10-14T10:24:03.118Z",
  "updated_at": "2026-10-14T10:24:03.118Z",
  "workspace_id": "0192f3a4-7b3c-7d2e-9f10-4a5b6c7d8e9f",
  "kind": "user",
  "workspace_user_id": "0192f3a4-8f22-7a04-b6c5-1d2e3f4a5b6c",
  "is_online": true,
  "last_seen_at": "2026-10-14T10:24:03.118Z",
  "presence_observed_at": "2026-10-14T10:24:03.118Z",
  "avatar_id": "0192f3a4-7b3c-7d2e-9f10-4a5b6c7d8e9f",
  "display_name": "deploys",
  "bio": "Keeps the deploys moving.",
  "position": "Engineer",
  "status_text": "Heads down",
  "status_emoji": "🎧",
  "agent_name": "Triage",
  "agent_handle": "triage"
}

curl -X PATCH https://api.fryll.com/workspace/actors/$WORKSPACE_ACTOR_ID \ -H "Authorization: Bearer $FRYLL_ACCESS_TOKEN" \ -H "X-Workspace-Id: $FRYLL_WORKSPACE_ID" \ -H "Content-Type: application/json" \ -d '{ "display_name": "deploys" }'

const res = await fetch(`https://api.fryll.com/workspace/actors/${workspaceActorId}`, { method: 'PATCH', headers: { 'Authorization': `Bearer ${process.env.FRYLL_ACCESS_TOKEN}`, 'X-Workspace-Id': process.env.FRYLL_WORKSPACE_ID!, 'Content-Type': 'application/json', }, body: JSON.stringify({ "display_name": "deploys" }), }); const data = await res.json();

{ "id": "0192f3a4-81d0-7c61-a3b2-5e6f7a8b9c0d", "created_at": "2026-10-14T10:24:03.118Z", "updated_at": "2026-10-14T10:24:03.118Z", "workspace_id": "0192f3a4-7b3c-7d2e-9f10-4a5b6c7d8e9f", "kind": "user", "workspace_user_id": "0192f3a4-8f22-7a04-b6c5-1d2e3f4a5b6c", "is_online": true, "last_seen_at": "2026-10-14T10:24:03.118Z", "presence_observed_at": "2026-10-14T10:24:03.118Z", "avatar_id": "0192f3a4-7b3c-7d2e-9f10-4a5b6c7d8e9f", "display_name": "deploys", "bio": "Keeps the deploys moving.", "position": "Engineer", "status_text": "Heads down", "status_emoji": "🎧", "agent_name": "Triage", "agent_handle": "triage" }