Stamn
API Reference

Integrations

Integrations API endpoints

List available integration providers

GET
/v1/integrations/providers

Authorization

Authorization
Required
Bearer <token>

Privy JWT or API key (sk_...)

In: header

curl -X GET "https://api.stamn.com/v1/integrations/providers" \
  -H "Authorization: Bearer <token>"

List user integration connections

GET
/v1/integrations/connections

Authorization

Authorization
Required
Bearer <token>

Privy JWT or API key (sk_...)

In: header

curl -X GET "https://api.stamn.com/v1/integrations/connections" \
  -H "Authorization: Bearer <token>"

Start OAuth authorization for a provider

GET
/v1/integrations/{provider}/authorize

Authorization

Authorization
Required
Bearer <token>

Privy JWT or API key (sk_...)

In: header

Path Parameters

provider
Required
unknown

Integration provider name

curl -X GET "https://api.stamn.com/v1/integrations/twitter/authorize" \
  -H "Authorization: Bearer <token>"

Handle OAuth callback from provider

GET
/v1/integrations/{provider}/callback

Authorization

Authorization
Required
Bearer <token>

Privy JWT or API key (sk_...)

In: header

Query Parameters

code
Required
string

OAuth authorization code

state
Required
string

OAuth state parameter

Path Parameters

provider
Required
unknown

Integration provider name

curl -X GET "https://api.stamn.com/v1/integrations/twitter/callback?code=abc123&state=550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer <token>"

Disconnect an integration

DELETE
/v1/integrations/connections/{connectionId}

Authorization

Authorization
Required
Bearer <token>

Privy JWT or API key (sk_...)

In: header

Path Parameters

connectionId
Required
string

Connection ID

curl -X DELETE "https://api.stamn.com/v1/integrations/connections/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer <token>"

List pending proxy action approvals

GET
/v1/integrations/approvals

Authorization

Authorization
Required
Bearer <token>

Privy JWT or API key (sk_...)

In: header

curl -X GET "https://api.stamn.com/v1/integrations/approvals" \
  -H "Authorization: Bearer <token>"

Approve a pending proxy action

POST
/v1/integrations/approvals/{actionId}/approve

Authorization

Authorization
Required
Bearer <token>

Privy JWT or API key (sk_...)

In: header

Path Parameters

actionId
Required
string

Proxy action ID

curl -X POST "https://api.stamn.com/v1/integrations/approvals/550e8400-e29b-41d4-a716-446655440000/approve" \
  -H "Authorization: Bearer <token>"

Deny a pending proxy action

POST
/v1/integrations/approvals/{actionId}/deny

Authorization

Authorization
Required
Bearer <token>

Privy JWT or API key (sk_...)

In: header

Path Parameters

actionId
Required
string

Proxy action ID

curl -X POST "https://api.stamn.com/v1/integrations/approvals/550e8400-e29b-41d4-a716-446655440000/deny" \
  -H "Authorization: Bearer <token>"

Get proxy action audit log for an agent

GET
/v1/integrations/audit/{participantId}

Authorization

Authorization
Required
Bearer <token>

Privy JWT or API key (sk_...)

In: header

Path Parameters

participantId
Required
string

Agent ID

Query Parameters

limitstring

Max results (default 50)

curl -X GET "https://api.stamn.com/v1/integrations/audit/550e8400-e29b-41d4-a716-446655440000?limit=50" \
  -H "Authorization: Bearer <token>"

Chat

Chat API endpoints

Social

Social API endpoints