Agentuity Documentation

Manage organizations, environment variables, and org-level resources.

Region

https://catalyst-usw.agentuity.cloud

Authentication

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 Organizations

List all organizations the authenticated user belongs to.

GET/cli/organization

https://catalyst-usw.agentuity.cloud/cli/organization

Response

Returns all organizations the authenticated user belongs to.

Status	Description
200	Organizations returned
401	Unauthorized — invalid or missing Bearer token

Response Fields

Field	Type	Description
`id`	string	Organization ID
`name`	string	Organization name

Example

curl -X GET 'https://catalyst-usw.agentuity.cloud/cli/organization' \
  -H 'Authorization: Bearer $AGENTUITY_SDK_KEY'

Environment Variables

Get Environment Variables

Retrieve environment variables and secrets for an organization.

GET/cli/organization/{id}/env

https://catalyst-usw.agentuity.cloud/cli/organization/{id}/env

Parameters

path

Name	Type	Required	Description
`id`	string	Yes	Organization ID

query

Name	Type	Required	Description
`mask`	boolean	No	Mask secret values (default true)

Response

Returns environment variables and secrets for the organization.

Status	Description
200	Environment variables returned
401	Unauthorized — invalid or missing Bearer token
404	Organization not found

Response Fields

Field	Type	Description
`id`	string	the organization id
`env`	object	environment variables (optional)
`secrets`	object	secrets (may be masked) (optional)

Example

curl -X GET 'https://catalyst-usw.agentuity.cloud/cli/organization/org_abc123/env' \
  -H 'Authorization: Bearer $AGENTUITY_SDK_KEY'

Update Environment Variables

Update environment variables and secrets for an organization. Updates are merged with existing values.

PUT/cli/organization/{id}/env

https://catalyst-usw.agentuity.cloud/cli/organization/{id}/env

Parameters

path

Name	Type	Required	Description
`id`	string	Yes	Organization ID

Request Body

Environment variables and secrets to set.

Field	Type	Description
`env`	object	environment variables to set/update (optional)
`secrets`	object	secrets to set/update (optional)

Response

Updates are merged with existing values. Returns 204 on success.

Status	Description
204	Environment variables updated
401	Unauthorized — invalid or missing Bearer token
404	Organization not found

Example

curl -X PUT 'https://catalyst-usw.agentuity.cloud/cli/organization/org_abc123/env' \
  -H 'Authorization: Bearer $AGENTUITY_SDK_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "env": {
    "MY_VAR": "value"
  },
  "secrets": {
    "API_KEY": "sk_..."
  }
}'

Delete Environment Variables

Delete specific environment variables and secrets from an organization.

DELETE/cli/organization/{id}/env

https://catalyst-usw.agentuity.cloud/cli/organization/{id}/env

Parameters

path

Name	Type	Required	Description
`id`	string	Yes	Organization ID

Request Body

Keys to delete from environment variables and secrets.

Field	Type	Description
`env`	string[]	environment variable keys to delete (optional)
`secrets`	string[]	secret keys to delete (optional)

Response

Returns 204 on success.

Status	Description
204	Environment variables deleted
401	Unauthorized — invalid or missing Bearer token
404	Organization not found

Example

curl -X DELETE 'https://catalyst-usw.agentuity.cloud/cli/organization/org_abc123/env' \
  -H 'Authorization: Bearer $AGENTUITY_SDK_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "env": [
    "MY_VAR"
  ],
  "secrets": [
    "OLD_KEY"
  ]
}'

Resources

List All Resources

List S3 buckets and databases across all regions.

GET/resource

https://catalyst-usw.agentuity.cloud/resource

Parameters

query

Name	Type	Required	Description
`type`	string	No	'all', 's3', or 'db' (default 'all')
`name`	string	No	Filter by name
`limit`	number	No	Maximum results to return
`offset`	number	No	Pagination offset
`sort`	string	No	'name', 'created', or 'region'
`direction`	string	No	'asc' or 'desc'

Response

Returns S3 buckets and databases across all regions.

Status	Description
200	Resources returned
401	Unauthorized — invalid or missing Bearer token

Example

curl -X GET 'https://catalyst-usw.agentuity.cloud/resource' \
  -H 'Authorization: Bearer $AGENTUITY_SDK_KEY'