Workspaces

Workspaces scope everything else in this API — domains, mailboxes, sequencers, orders. A team can run more than one (agencies commonly create one per client).

Method	Path	Description
`GET`	`/v1/api/workspaces/list`	List workspaces on your team
`GET`	`/v1/api/workspaces/details`	Get one workspace’s details
`POST`	`/v1/api/workspaces/create`	Create a workspace
`PUT`	`/v1/api/workspaces/update`	Update a workspace
`DELETE`	`/v1/api/workspaces/delete`	Delete a workspace
`POST`	`/v1/api/workspaces/webhook`	Set/update a workspace’s webhook URL
`POST`	`/v1/api/workspaces/invite`	Invite a member to a workspace

Create a workspace


curl -X POST https://api.infrabox.software/v1/api/workspaces/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Client A", "webhook_url": "https://your-app.com/webhooks/infrabox" }'

workspaces/create and /list don’t need X-Workspace-Id (there’s no workspace to scope to yet / you’re listing across all of them) — every other workspace endpoint does.

Invite a member


curl -X POST https://api.infrabox.software/v1/api/workspaces/invite \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "role": "member",
    "workspace_uid": "ws_123456789"
  }'

role is admin or member. Set resend: true to re-send an invitation that was already sent.

Errors

Status	Meaning
`400`	Invalid body (e.g. missing `name` on create)
`401`	Missing/invalid API key
`404`	Workspace not found
`500`	Internal error