Organizations

Organizations are the top-level container for all resources in PDaaS. Each organization is completely isolated from others.

The Organization Object

{
  "id": "org-abc123xyz",
  "name": "Acme Corporation",
  "slug": "abc123",
  "is_active": true,
  "metadata": {},
  "created_at": "2025-09-30T10:00:00Z",
  "updated_at": "2025-09-30T10:00:00Z"
}

Attributes

Attribute	Type	Description
id	string	Unique identifier for the organization
name	string	Human-friendly organization name
slug	string	6-character DNS-safe identifier (e.g., abc123)
is_active	boolean	Whether the organization is active
metadata	object	Optional metadata (key-value pairs)
created_at	string	ISO 8601 timestamp of creation
updated_at	string	ISO 8601 timestamp of last update

Get Organization Info

Retrieves information about the current organization (inferred from service account context).

GET /organizations/info

Example Request

curl https://api.console.solucao42.com.br/organizations/info \
  -H "Authorization: HMAC sa_abc123_acc456_xyz:signature" \
  -H "x-date: 2025-09-30T12:00:00Z" \
  -H "x-nonce: unique-request-id" \
  -H "x-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"

Example Response

{
  "id": "org-abc123xyz",
  "name": "Acme Corporation",
  "slug": "abc123",
  "is_active": true,
  "metadata": {
    "industry": "Technology",
    "size": "Enterprise"
  },
  "created_at": "2025-09-30T10:00:00Z",
  "updated_at": "2025-09-30T10:00:00Z"
}

Response Codes

Code	Description
200	Success
401	Authentication failed
403	Insufficient permissions

Update Organization

Updates the current organization's information.

PATCH /organizations/info

Request Body

{
  "name": "Acme Corporation Inc.",
  "metadata": {
    "industry": "Technology",
    "size": "Enterprise",
    "region": "North America"
  }
}

Example Request

curl -X PATCH https://api.console.solucao42.com.br/organizations/info \
  -H "Authorization: HMAC sa_abc123_acc456_xyz:signature" \
  -H "Content-Type: application/json" \
  -H "x-date: 2025-09-30T12:00:00Z" \
  -H "x-nonce: unique-request-id-2" \
  -H "x-content-sha256: <body-hash>" \
  -d '{
    "name": "Acme Corporation Inc."
  }'

Example Response

{
  "id": "org-abc123xyz",
  "name": "Acme Corporation Inc.",
  "slug": "abc123",
  "is_active": true,
  "metadata": {
    "industry": "Technology",
    "size": "Enterprise",
    "region": "North America"
  },
  "created_at": "2025-09-30T10:00:00Z",
  "updated_at": "2025-09-30T12:30:00Z"
}

Response Codes

Code	Description
200	Success
400	Invalid request body
401	Authentication failed
403	Insufficient permissions
422	Validation error

Permissions

Required Permissions

Action	Permission
Get organization info	organizations:GetOrganization
Update organization	organizations:UpdateOrganization

Related Resources

• Accounts - Manage accounts within the organization
• Users - Manage organization users
• Service Accounts - Manage service accounts

Notes

• The organization slug cannot be changed after creation
• The slug is used in API key prefixes (e.g., sa_abc123_acc456_xyz)
• Organizations are completely isolated - service accounts cannot access other organizations