Get Integration

GET

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

GET

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

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

1 {
2   "id": "019f8a04-5e54-7001-9f5e-6e9031824041",
3   "project_id": "019f8a00-1a10-7002-8b1a-2a5c9d4e0002",
4   "type": "slack",
5   "name": "Slack",
6   "auth_type": "oauth_project_default",
7   "created": "2026-05-10T10:00:00Z",
8   "modified": "2026-05-10T10:00:00Z",
9   "tools": [
10     {
11       "id": "019f8a04-5e54-7003-9f5e-6e9031824043",
12       "name": "slack_chat_post_message",
13       "tool_name": "slack_chat_post_message",
14       "safe_tool_name": "slack_chat_post_message",
15       "enabled": true,
16       "default_selected": true,
17       "created": "2026-05-10T10:00:00Z",
18       "modified": "2026-05-10T10:00:00Z",
19       "description": "Post a message to a Slack channel after validating the channel ID or name.",
20       "tool_description": "Post a message to a Slack channel after validating the channel ID or name.",
21       "tool_input_schema": {
22         "properties": {
23           "channel_id": {
24             "description": "Slack channel ID. Provide exactly one of channel_id or channel_name.",
25             "type": "string"
26           },
27           "channel_name": {
28             "description": "Slack channel name without #. Provide exactly one of channel_id or channel_name.",
29             "type": "string"
30           },
31           "mrkdwn": {
32             "description": "Whether Slack mrkdwn formatting is enabled. Defaults to true.",
33             "type": "boolean"
34           },
35           "text": {
36             "description": "Message text to post.",
37             "type": "string"
38           },
39           "thread_ts": {
40             "description": "Optional thread timestamp to reply in a thread.",
41             "type": "string"
42           }
43         },
44         "required": [
45           "text"
46         ],
47         "type": "object"
48       }
49     }
50   ],
51   "setup_instructions": "Connect Slack so agents can list channels and post messages through the project bot installation."
52 }

Retrieve a project integration, including persisted tools and setup guidance. 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

integration_idstringRequiredformat: "uuid"

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

Integration 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