Workspaces and teams

A workspace is the container for your API keys, usage, workflows, and team. Every account starts with one, and everything you do through the API runs inside it. This guide walks you through creating a workspace, bringing your team in, and giving each person the right level of access.

Before you start

Get an API key

Every request needs a bearer key. Grab one from the dashboard or read Authentication.

Set your base URL

All calls in this guide go to https://developer.encrata.com with an Authorization: Bearer enc_... header.

Workspace endpoints accept either a dashboard session or an enc_ API key, so the same calls work from your app, the CLI, and an agent.

Set up your workspace

Create a workspace

Send a name. The slug is optional and is generated from the name when you omit it.

curl -X POST "https://developer.encrata.com/api/workspaces" \
  -H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Acme Data" }'

A 201 returns the new workspace. The creator is added as an active admin automatically.

{
  "id": "b3f1c2a4-5d6e-4f70-8a1b-9c2d3e4f5a6b",
  "public_id": "wsp_7K4mQ9xT2vN8cR5p",
  "name": "Acme Data",
  "slug": "acme-data",
  "logo_url": null,
  "created_by": "a1b2c3d4-e5f6-4711-8899-aabbccddeeff",
  "created_at": "2026-01-15T10:00:00Z"
}

Field	Type	Required	Description
`name`	string	Yes	Display name, 1-48 characters. Letters, numbers, spaces, apostrophes, and hyphens only.
`slug`	string	No	URL-friendly identifier. Auto-generated from `name` if omitted. Must be unique.
`logo_url`	string	No	URL of the workspace logo.

Invite your team

Invite by email and set the role they land with. The role defaults to readonly when you omit it. The invitee gets an email with a link to accept.

curl -X POST "https://developer.encrata.com/api/workspaces/members" \
  -H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "email": "bob@acme.com", "role": "tech" }'

A 201 returns the pending membership.

{
  "id": "7a0b1c2d-3e4f-4051-8b6c-8d9e0f1a2b3c",
  "workspace_id": "b3f1c2a4-5d6e-4f70-8a1b-9c2d3e4f5a6b",
  "user_id": null,
  "email": "bob@acme.com",
  "role": "tech",
  "status": "pending",
  "invited_at": "2026-01-16T09:30:00Z",
  "joined_at": null
}

Field	Type	Required	Description
`email`	string	Yes	Email address to invite.
`role`	string	No	`admin`, `tech`, or `readonly`. Defaults to `readonly`.

Only an admin can invite. Inviting an address that already has a pending invite re-sends it, rate-limited to once per minute.

Accept the invite

The invited person signs in with the invited email, then posts the token from their invitation link.

curl -X POST "https://developer.encrata.com/api/workspaces/accept" \
  -H "Authorization: Bearer enc_1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d" \
  -H "Content-Type: application/json" \
  -d '{ "token": "b7f3...invite-token" }'

{ "message": "Invite accepted" }

The signed-in account must match the invited email. An invite for bob@acme.com can only be accepted by the account that owns that address.

Choose a role for each member

Every member holds one role: admin, tech, or readonly. You set it when you invite someone, and an admin can change it later. Give each person the lowest role that covers their work.

admin runs the workspace. Admins manage settings and members, and can delete the workspace. The workspace creator starts here.
tech builds with the API. Tech members run lookups, manage API keys, build workflows and webhooks, handle files, and buy credits. They cannot manage workspace settings or members.
readonly observes. Read-only members run lookups and view workflows, files, and webhooks. They cannot create, change, or delete anything.

What each role can do

Feature	`admin`	`tech`	`readonly`
Run lookups, manage API keys, and use AI Chat	✓	✓	✓
Create, edit, delete, and run workflows	✓	✓	✗
View workflows and their runs	✓	✓	✓
Use workflow templates	✓	✓	Browse only
Upload, delete, and share files	✓	✓	✗
Browse, preview, and download files	✓	✓	✓
Create, edit, delete, and test webhooks	✓	✓	✗
View webhooks and their logs	✓	✓	✓
Buy credits, manage the card, and set auto top-up	✓	✓	✗
View credit usage	✓	✓	✓
Edit workspace name, slug, and logo	✓	✗	✗
Invite and manage members	✓	✗	✗
Delete the workspace	✓	✗	✗
Edit your profile, leave the workspace, and log out	✓	✓	✓
Delete your account	✓	✗	✗

An account that doesn’t belong to any workspace yet has admin access.

There is no separate owner role. The person who creates a workspace is added as an admin and cannot be removed or leave while they are the last admin.

Manage members

List members

Returns every member of your current workspace. Pass ?workspace_id= to read a specific workspace you belong to.

curl "https://developer.encrata.com/api/workspaces/members" \
  -H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

[
  {
    "id": "6f9a1b2c-3d4e-4f50-8a6b-7c8d9e0f1a2b",
    "workspace_id": "b3f1c2a4-5d6e-4f70-8a1b-9c2d3e4f5a6b",
    "user_id": "a1b2c3d4-e5f6-4711-8899-aabbccddeeff",
    "email": "alice@acme.com",
    "role": "admin",
    "status": "active",
    "invited_at": "2026-01-15T10:00:00Z",
    "joined_at": "2026-01-15T10:00:00Z",
    "name": "Alice"
  }
]

Change a member's role

Pass the member id (from the list response), not the user id. Admin only.

curl -X PUT "https://developer.encrata.com/api/workspaces/members" \
  -H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "member_id": "7a0b1c2d-3e4f-4051-8b6c-8d9e0f1a2b3c", "role": "admin" }'

{ "message": "Role updated" }

Field	Type	Required	Description
`member_id`	string	Yes	Member id to update.
`role`	string	Yes	New role: `admin`, `tech`, or `readonly`.

You cannot demote the last remaining admin. Promote someone else first.

Remove a member

Pass the member id as the id query parameter. Admin only. To remove yourself, use Leave a workspace instead.

curl -X DELETE "https://developer.encrata.com/api/workspaces/members?id=7a0b1c2d-3e4f-4051-8b6c-8d9e0f1a2b3c" \
  -H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

{ "message": "Member removed" }

Leave a workspace

Leaving requires an OTP code for security. Check whether you can leave with a GET, then confirm with a POST and the code.

# 1. Check you're allowed to leave
curl "https://developer.encrata.com/api/workspaces/leave" \
  -H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# 2. Confirm with the verification code
curl -X POST "https://developer.encrata.com/api/workspaces/leave" \
  -H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "code": "123456" }'

{ "message": "You have left the workspace" }

You cannot leave if you are the only member or the last admin.

Manage workspaces

List your workspaces

curl "https://developer.encrata.com/api/workspaces" \
  -H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Returns every workspace you belong to.

Switch your active workspace

Use PUT, not POST. This sets which workspace subsequent calls run against.

curl -X PUT "https://developer.encrata.com/api/workspaces/switch" \
  -H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "workspace_id": "b3f1c2a4-5d6e-4f70-8a1b-9c2d3e4f5a6b" }'

{ "message": "Workspace switched" }

Update workspace settings

Updates your current workspace when workspace_id is omitted. Admin only.

curl -X PUT "https://developer.encrata.com/api/workspaces" \
  -H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Acme Data Team", "logo_url": "https://acme.com/logo.png" }'

{ "message": "Workspace updated" }

Field	Type	Required	Description
`name`	string	Yes	New workspace name, 1-48 characters.
`slug`	string	No	New slug. Must be unique.
`logo_url`	string	No	Logo URL.
`workspace_id`	string	No	Workspace to update. Defaults to your current workspace.

Delete a workspace

Deletes your current workspace and all of its data. Admin only.

curl -X DELETE "https://developer.encrata.com/api/workspaces" \
  -H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

{ "message": "Workspace deleted" }

This permanently deletes the workspace, its members, API keys, and workflows. It cannot be undone.

Next steps

Authentication: Create and manage the API keys your workspace uses.
Run a workflow: Automate lookups across your team’s contact lists.
Bulk operations: Process large batches inside your workspace.
API reference: Full endpoint details and response fields.

Account & team

Run your integration

Use cases

Integrations

AI tools

auth.md

Workspaces and teams

Before you start

Set up your workspace

Choose a role for each member

What each role can do

Manage members

Manage workspaces

Next steps

​Before you start

​Set up your workspace

​Choose a role for each member

​What each role can do

​Manage members

​Manage workspaces

​Next steps

Before you start

Set up your workspace

Choose a role for each member

What each role can do

Manage members

Manage workspaces

Next steps