Reference

Organization Endpoints


Organization Management

Create Organization

1
POST /api/v1/organizations
2
Authorization: Bearer <token>
3
Content-Type: application/json
4
5
{
6
"name": "Acme Corp",
7
"slug": "acme-corp",
8
"description": "Main organization"
9
}

Response:

1
{
2
"organization_id": "org_123",
3
"name": "Acme Corp",
4
"slug": "acme-corp",
5
"owner_id": "usr_123",
6
"created_at": "2024-01-07T12:00:00Z"
7
}

List Organizations

1
GET /api/v1/organizations
2
Authorization: Bearer <token>

Get Organization

1
GET /api/v1/organizations/:org_id
2
Authorization: Bearer <token>

Update Organization

1
PUT /api/v1/organizations/:org_id
2
Authorization: Bearer <token>
3
Content-Type: application/json
4
5
{
6
"name": "Acme Corporation",
7
"description": "Updated description"
8
}

Delete Organization

1
DELETE /api/v1/organizations/:org_id
2
Authorization: Bearer <token>

Member Management

List Members

1
GET /api/v1/organizations/:org_id/members
2
Authorization: Bearer <token>

Update Member Role

1
PUT /api/v1/organizations/:org_id/members/:member_id/role
2
Authorization: Bearer <token>
3
Content-Type: application/json
4
5
{
6
"role": "admin"
7
}

Remove Member

1
DELETE /api/v1/organizations/:org_id/members/:member_id
2
Authorization: Bearer <token>

Invitations

Invite Member

1
POST /api/v1/organizations/:org_id/invitations
2
Authorization: Bearer <token>
3
Content-Type: application/json
4
5
{
6
"email": "member@example.com",
7
"role": "developer"
8
}

Response:

1
{
2
"invitation_id": "inv_789",
3
"email": "member@example.com",
4
"role": "developer",
5
"status": "pending",
6
"expires_at": "2024-01-14T12:00:00Z"
7
}

Accept Invitation

1
POST /api/v1/invitations/accept
2
Authorization: Bearer <token>
3
Content-Type: application/json
4
5
{
6
"invitation_id": "inv_789"
7
}

Next Steps

  • Users — User account management
  • Registry — Workflow registration and deployment
  • Namespaces — Multi-tenancy and isolation