Organizations & Members

Organizations are sub-groups within a workspace. Each workspace can contain multiple organizations — for example, separate brands, teams, or clients. Members belong to a specific organization and their access is scoped to it.

Base URL: https://pharlo.io
Auth: Authorization: Bearer <jwt_token>

Roles

The owner role is assigned to the organization creator and cannot be transferred via API — only one owner per organization is allowed.

To invite a new user, see Invitations.

Endpoints

GET /api/v1/auth/organizations

Returns all organizations the authenticated user belongs to, along with the user's role in each.

Example request

curl https://pharlo.io/api/v1/auth/organizations \
  -H "Authorization: Bearer $JWT_TOKEN"

Response 200 OK

{
  "items": [
    {
      "id": "018e1f3a-7c2b-7000-8f4d-1a2b3c4d5e6f",
      "name": "Acme Corp",
      "slug": "acme-corp",
      "role": "owner",
      "memberCount": 4
    }
  ]
}

GET /api/v1/auth/organizations/{id}

Returns full details of a specific organization. The authenticated user must be a member of it.

Path parameters

Example request

curl https://pharlo.io/api/v1/auth/organizations/018e1f3a-7c2b-7000-8f4d-1a2b3c4d5e6f \
  -H "Authorization: Bearer $JWT_TOKEN"

Response 200 OK

{
  "id": "018e1f3a-7c2b-7000-8f4d-1a2b3c4d5e6f",
  "name": "Acme Corp",
  "slug": "acme-corp",
  "owner": {
    "id": "018e1f3a-9d3c-7000-af5e-2b3c4d5e6f7a",
    "name": "Alice",
    "email": "alice@example.com"
  },
  "createdAt": "2026-01-01T00:00:00Z"
}

GET /api/v1/auth/organizations/{id}/members

Returns a list of all members in the organization. Available to any organization member.

Path parameters

Example request

curl https://pharlo.io/api/v1/auth/organizations/018e1f3a-7c2b-7000-8f4d-1a2b3c4d5e6f/members \
  -H "Authorization: Bearer $JWT_TOKEN"

Response 200 OK

{
  "items": [
    {
      "id": "018e2a4b-1c3d-7000-9e5f-3c4d5e6f7a8b",
      "user": {
        "id": "018e1f3a-9d3c-7000-af5e-2b3c4d5e6f7a",
        "name": "Alice",
        "email": "alice@example.com"
      },
      "role": "owner",
      "joinedAt": "2026-01-01T00:00:00Z"
    },
    {
      "id": "018e3b5c-2d4e-7000-af6a-4d5e6f7a8b9c",
      "user": {
        "id": "018e3b5c-8e4f-7000-bf7b-5e6f7a8b9c0d",
        "name": "Bob",
        "email": "bob@example.com"
      },
      "role": "member",
      "joinedAt": "2026-02-15T00:00:00Z"
    }
  ]
}

PATCH /api/v1/auth/organizations/{orgId}/members/{memberId}/role

Changes a member's role within the organization. Requires owner or admin role.

Path parameters

Request body

Example request

curl -X PATCH \
  https://pharlo.io/api/v1/auth/organizations/018e1f3a-7c2b-7000-8f4d-1a2b3c4d5e6f/members/018e3b5c-2d4e-7000-af6a-4d5e6f7a8b9c/role \
  -H "Authorization: Bearer $JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"role": "admin"}'

Response 200 OK

{
  "id": "018e3b5c-2d4e-7000-af6a-4d5e6f7a8b9c",
  "role": "admin"
}

DELETE /api/v1/auth/organizations/{orgId}/members/{memberId}

Removes a member from the organization. Requires owner or admin role.

Path parameters

Example request

curl -X DELETE \
  https://pharlo.io/api/v1/auth/organizations/018e1f3a-7c2b-7000-8f4d-1a2b3c4d5e6f/members/018e3b5c-2d4e-7000-af6a-4d5e6f7a8b9c \
  -H "Authorization: Bearer $JWT_TOKEN"

Response 204 No Content

No response body. A 204 confirms the member was removed successfully.

Error responses

{
  "error": "Access denied",
  "details": {}
}

See Error Handling for the full list of error codes.

See also

• Invitations — invite users to join an organization by email
• User Auth — register, log in, and manage user profiles
• Authentication guide — overview of JWT and API key auth
• Core Concepts — domain model: workspaces, organizations, connections, assignments