List available cloud regions and manage per-region resources.
https://catalyst-usw.agentuity.cloudAuthentication
All requests require a Bearer token. Pass your SDK key in the Authorization header.
| Header | Value |
|---|---|
Authorization | Bearer YOUR_SDK_KEY |
You can find your SDK key in the Agentuity Console under your project settings.
List Regions
List all available cloud regions.
GET
/cli/regionhttps://catalyst-usw.agentuity.cloud/cli/regionResponse
Array of region objects.
| Status | Description |
|---|---|
| 200 | Regions returned |
| 401 | Unauthorized — invalid or missing Bearer token |
Response Fields
| Field | Type | Description |
|---|---|---|
region | string | Region identifier |
description | string | Human-readable region name |
Example
curl -X GET 'https://catalyst-usw.agentuity.cloud/cli/region' \
-H 'Authorization: Bearer $AGENTUITY_SDK_KEY'Resource Management
List Region Resources
List resources provisioned in a specific region for an organization.
GET
/resource/{orgId}/{region}https://catalyst-usw.agentuity.cloud/resource/{orgId}/{region}Parameters
path
| Name | Type | Required | Description |
|---|---|---|---|
orgId | string | Yes | Organization ID |
region | string | Yes | Region identifier |
Response
Returns S3 buckets, databases, and optional Redis resources for the specified region.
| Status | Description |
|---|---|
| 200 | Region resources returned |
| 401 | Unauthorized — invalid or missing Bearer token |
| 404 | Organization or region not found |
Example
curl -X GET 'https://catalyst-usw.agentuity.cloud/resource/org_abc123/usw' \
-H 'Authorization: Bearer $AGENTUITY_SDK_KEY'Create Resources
Create resources in a specific region for an organization.
POST
/resource/{orgId}/{region}https://catalyst-usw.agentuity.cloud/resource/{orgId}/{region}Parameters
path
| Name | Type | Required | Description |
|---|---|---|---|
orgId | string | Yes | Organization ID |
region | string | Yes | Region identifier |
Request Body
Resource creation payload.
| Field | Type | Description |
|---|---|---|
resources | array | Array of { type: 'db'|'s3', name?, description? } |
Response
Created resource objects.
| Status | Description |
|---|---|
| 201 | Resources created |
| 401 | Unauthorized — invalid or missing Bearer token |
| 404 | Organization or region not found |
Example
curl -X POST 'https://catalyst-usw.agentuity.cloud/resource/org_abc123/usw' \
-H 'Authorization: Bearer $AGENTUITY_SDK_KEY' \
-H 'Content-Type: application/json' \
-d '{
"resources": [
{
"type": "db",
"name": "mydb"
}
]
}'Delete Resources
Delete resources in a specific region for an organization.
DELETE
/resource/{orgId}/{region}https://catalyst-usw.agentuity.cloud/resource/{orgId}/{region}Parameters
path
| Name | Type | Required | Description |
|---|---|---|---|
orgId | string | Yes | Organization ID |
region | string | Yes | Region identifier |
Request Body
Resource deletion payload.
| Field | Type | Description |
|---|---|---|
resources | array | Array of { type: 'db'|'s3', name } |
Response
Empty response on success.
| Status | Description |
|---|---|
| 204 | Resources deleted |
| 401 | Unauthorized — invalid or missing Bearer token |
| 404 | Organization or region not found |
Example
curl -X DELETE 'https://catalyst-usw.agentuity.cloud/resource/org_abc123/usw' \
-H 'Authorization: Bearer $AGENTUITY_SDK_KEY' \
-H 'Content-Type: application/json' \
-d '{
"resources": [
{
"type": "db",
"name": "mydb"
}
]
}'