Regions API — Agentuity Documentation

Regions API

List available cloud regions and manage per-region resources

List available cloud regions and manage per-region resources.

https://catalyst-usw.agentuity.cloud

Authentication

All requests require a Bearer token. Pass your SDK key in the Authorization header.

HeaderValue
AuthorizationBearer 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/region
https://catalyst-usw.agentuity.cloud/cli/region

Response

Array of region objects.

StatusDescription
200Regions returned
401Unauthorized — invalid or missing Bearer token

Response Fields

FieldTypeDescription
regionstringRegion identifier
descriptionstringHuman-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
NameTypeRequiredDescription
orgIdstringYesOrganization ID
regionstringYesRegion identifier

Response

Returns S3 buckets, databases, and optional Redis resources for the specified region.

StatusDescription
200Region resources returned
401Unauthorized — invalid or missing Bearer token
404Organization 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
NameTypeRequiredDescription
orgIdstringYesOrganization ID
regionstringYesRegion identifier

Request Body

Resource creation payload.

FieldTypeDescription
resourcesarrayArray of { type: 'db'|'s3', name?, description? }

Response

Created resource objects.

StatusDescription
201Resources created
401Unauthorized — invalid or missing Bearer token
404Organization 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
NameTypeRequiredDescription
orgIdstringYesOrganization ID
regionstringYesRegion identifier

Request Body

Resource deletion payload.

FieldTypeDescription
resourcesarrayArray of { type: 'db'|'s3', name }

Response

Empty response on success.

StatusDescription
204Resources deleted
401Unauthorized — invalid or missing Bearer token
404Organization 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"
    }
  ]
}'