An organization is the top-level container for all resources in Probo — users, vendors, risks, frameworks, and everything else belong to an organization.
The Organization object
Global ID (GID) of the organization.
Display name of the organization.
Optional description of the organization.
created_at
string (date-time)
required
ISO 8601 timestamp of when the organization was created.
updated_at
string (date-time)
required
ISO 8601 timestamp of the last update.
Operations
listOrganizations
Returns the organizations accessible to the authenticated user.
MCP tool: listOrganizations
Parameters
Filter results to a specific organization GID.
Response
Array of organization objects.
Example
curl -X POST https://your-probo-instance/api/mcp/v1 \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "listOrganizations",
"arguments": {}
}
}'
Example response
{
"organizations": [
{
"id": "gid://probo/Organization/01J5XKZW9QMXP3N6V8HTJA2FKB",
"name": "Acme Corp",
"description": "Acme Corporation security team",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-06-01T14:22:00Z"
}
]
}
Most other API operations require an organization_id. Use listOrganizations to retrieve the GID for your organization before making other requests.
