Skip to main content

​
Overview

Manage organizations, members, and settings programmatically.

​
Get Organization

GET /api/organizations/:id 
curl https://api.sorcia.ai/api/organizations/org_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

{
  "id": "org_abc123",
  "name": "Acme Inc",
  "billing_tier": "pro",
  "member_count": 15,
  "created_at": "2024-01-01T00:00:00Z"
}

​
List Members

GET /api/organizations/:id/members 
curl https://api.sorcia.ai/api/organizations/org_abc123/members \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

{
  "members": [
    {
      "user_id": "user_123",
      "email": "john@acme.com",
      "role": "owner",
      "joined_at": "2024-01-01T00:00:00Z"
    }
  ]
}

​
Invite Member

POST /api/organizations/:id/members 
curl -X POST https://api.sorcia.ai/api/organizations/org_abc123/members \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "email": "newuser@acme.com",
    "role": "member"
  }'

​
Request Parameters

​
email
string
required
User email address
​
role
string
required
User role: owner, admin, or member

​
Remove Member

DELETE /api/organizations/:id/members/:user_id 
curl -X DELETE https://api.sorcia.ai/api/organizations/org_abc123/members/user_123 \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Update Member Role

PATCH /api/organizations/:id/members/:user_id 
curl -X PATCH https://api.sorcia.ai/api/organizations/org_abc123/members/user_123 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"role": "admin"}'

​
Organization Settings

PATCH /api/organizations/:id/settings 
curl -X PATCH https://api.sorcia.ai/api/organizations/org_abc123/settings \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "name": "Acme Corporation",
    "features": {
      "slack_integration": true,
      "api_access": true
    }
  }'

​
Next Steps

Authentication

API authentication guide