List Integrations

GET

/org/:org_id/project/:project_id/integration

GET

/api/v1/org/:org_id/project/:project_id/integration

$ curl https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/integration \
>      -H "Authorization: Bearer <token>"

1 [
2   {
3     "id": "019f8a04-5e54-7001-9f5e-6e9031824041",
4     "project_id": "019f8a00-1a10-7002-8b1a-2a5c9d4e0002",
5     "type": "slack",
6     "name": "Slack",
7     "auth_type": "oauth_project_default",
8     "created": "2026-05-10T10:00:00Z",
9     "modified": "2026-05-10T10:00:00Z",
10     "tools": [
11       {
12         "id": "019f8a04-5e54-7003-9f5e-6e9031824043",
13         "name": "slack_chat_post_message",
14         "tool_name": "slack_chat_post_message",
15         "safe_tool_name": "slack_chat_post_message",
16         "enabled": true,
17         "default_selected": true,
18         "created": "2026-05-10T10:00:00Z",
19         "modified": "2026-05-10T10:00:00Z",
20         "description": "Post a message to a Slack channel after validating the channel ID or name.",
21         "tool_description": "Post a message to a Slack channel after validating the channel ID or name.",
22         "tool_input_schema": {
23           "properties": {
24             "channel_id": {
25               "description": "Slack channel ID. Provide exactly one of channel_id or channel_name.",
26               "type": "string"
27             },
28             "channel_name": {
29               "description": "Slack channel name without #. Provide exactly one of channel_id or channel_name.",
30               "type": "string"
31             },
32             "mrkdwn": {
33               "description": "Whether Slack mrkdwn formatting is enabled. Defaults to true.",
34               "type": "boolean"
35             },
36             "text": {
37               "description": "Message text to post.",
38               "type": "string"
39             },
40             "thread_ts": {
41               "description": "Optional thread timestamp to reply in a thread.",
42               "type": "string"
43             }
44           },
45           "required": [
46             "text"
47           ],
48           "type": "object"
49         }
50       }
51     ],
52     "setup_instructions": "Connect Slack so agents can list channels and post messages through the project bot installation."
53   },
54   {
55     "id": "019f8a04-5e54-7004-9f5e-6e9031824044",
56     "project_id": "019f8a00-1a10-7002-8b1a-2a5c9d4e0002",
57     "type": "google_sheets",
58     "name": "Google Sheets",
59     "auth_type": "oauth_project_default",
60     "created": "2026-06-02T09:00:00Z",
61     "modified": "2026-06-02T09:00:00Z",
62     "tools": [
63       {
64         "id": "019f8a04-5e54-7005-9f5e-6e9031824045",
65         "name": "sheets_spreadsheets_values_append",
66         "tool_name": "sheets_spreadsheets_values_append",
67         "safe_tool_name": "sheets_spreadsheets_values_append",
68         "enabled": true,
69         "default_selected": true,
70         "created": "2026-06-02T09:00:00Z",
71         "modified": "2026-06-02T09:00:00Z",
72         "description": "Append one or more rows to a Google Sheets table. Use this for adding new rows, not overwriting existing cells or changing formatting.",
73         "tool_description": "Append one or more rows to a Google Sheets table. Use this for adding new rows, not overwriting existing cells or changing formatting.",
74         "tool_input_schema": {
75           "properties": {
76             "major_dimension": {
77               "description": "Use ROWS unless intentionally appending columns.",
78               "enum": [
79                 "ROWS",
80                 "COLUMNS"
81               ],
82               "type": "string"
83             },
84             "range": {
85               "description": "A1 notation table-search range. Use `A:L` only for the default first sheet. For a specific tab, use its exact title, for example `'All Transcripts'!A:L`.",
86               "type": "string"
87             },
88             "spreadsheet_id": {
89               "description": "The target spreadsheet ID.",
90               "type": "string"
91             },
92             "value_input_option": {
93               "description": "How input values are interpreted. Prefer USER_ENTERED for normal spreadsheet entry.",
94               "enum": [
95                 "RAW",
96                 "USER_ENTERED"
97               ],
98               "type": "string"
99             },
100             "values": {
101               "description": "Rows to append as a 2D array.",
102               "items": {
103                 "items": {
104                   "type": "string"
105                 },
106                 "type": "array"
107               },
108               "type": "array"
109             }
110           },
111           "required": [
112             "spreadsheet_id",
113             "range",
114             "value_input_option",
115             "values"
116           ],
117           "type": "object"
118         }
119       }
120     ],
121     "setup_instructions": "Connect Google Sheets so agents can read and update spreadsheets in this project."
122   }
123 ]

List platform integrations configured for the project. Disabled tools are excluded by default and can be included for management interfaces.

Authentication

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

Path parameters

org_idstringRequiredformat: "uuid"

The unique identifier of the organization.

project_idstringRequiredformat: "uuid"

The unique identifier of the project.

Query parameters

include_disabled_toolsbooleanOptionalDefaults to false

Include disabled integration tools in the response. Disabled tools cannot be used at runtime.

Response

Integrations retrieved

idstringformat: "uuid"

project_idstringformat: "uuid"

typeenum

namestring

auth_typeenum

createdstring

modifiedstring

configmap from strings to any or nullOptional

toolslist of objectsOptionalDefaults to []

setup_instructionsstring or nullOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error