API ReferenceConsumer

Upsert consumer tool permissions for a connected accountv3.1

Markdown
PATCH
/api/v3.1/consumer/connected_accounts/{nanoid}/permissions

Upserts durable Enhanced Control per-tool permission rows for a connected account. This is a scaffolded write path for initial connect/settings flows.

Authorization

x-api-key<token>

Project API key authentication

In: header

Path Parameters

nanoidstringRequired

Connected account nano ID.

Format: connectedAccountId

Request Body

application/json

permissionsarray of objectRequired

Tool permission rows to upsert for this connected account.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://backend.composio.dev/api/v3.1/consumer/connected_accounts/ca_1a2b3c4d5e6f/permissions" \  -H "Content-Type: application/json" \  -d '{    "permissions": [      {        "tool_slug": "string",        "toolkit_slug": "string",        "risk_group": "read",        "state": "always_allow"      }    ]  }'
{
  "permissions": [
    {
      "id": "string",
      "connected_account_id": "string",
      "tool_slug": "string",
      "toolkit_slug": "string",
      "risk_group": "read",
      "state": "always_allow",
      "source": "initial_connect",
      "permission_config_version": "string",
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z"
    }
  ]
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}