List connectors

GET

https://ah-api.merge.dev/api/v1/connectors/

GET

/api/v1/connectors/

$ curl https://ah-api.merge.dev/api/v1/connectors/ \
>      -H "Authorization: Bearer <token>"

1 {
2   "count": 123,
3   "results": [
4     {
5       "id": "134e0111-0f67-44f6-98f0-597000290bb3",
6       "name": "Linear",
7       "slug": "linear",
8       "description": "A connector to the Linear project management platform",
9       "source_url": "https://linear.app",
10       "logo_url": "https://linear.app/favicon.ico",
11       "categories": [
12         "Project Management"
13       ],
14       "auth_options": [
15         {
16           "type": "Secrets",
17           "secrets": [
18             {
19               "name": "api_key",
20               "human_readable_name": "API key",
21               "field_type": "TEXT",
22               "options": [
23                 {
24                   "label": "string",
25                   "value": "string",
26                   "default": true
27                 }
28               ]
29             }
30           ]
31         },
32         {
33           "type": "OAuth2",
34           "secrets": []
35         }
36       ],
37       "tools": [
38         {
39           "name": "create_issue",
40           "description": "Create a new issue in Linear",
41           "credit_type": "string"
42         },
43         {
44           "name": "list_issues",
45           "description": "List issues in Linear",
46           "credit_type": "string"
47         }
48       ],
49       "source": "git"
50     }
51   ],
52   "next": "https://ah-api.merge.dev/api/v1/connectors/?page=4",
53   "previous": "https://ah-api.merge.dev/api/v1/connectors/?page=2"
54 }

Retrieves a list of Connectors

Authentication

AuthorizationBearer

Token-based authentication with required prefix “Bearer”

Query parameters

pageintegerOptional

A page number within the paginated result set.

page_sizeintegerOptional

Number of results to return per page.

searchstringOptional

Case-insensitive filter across connector name and slug. Only connectors matching the term are returned.

Response

countinteger

resultslist of objects

nextstring or nullOptionalformat: "uri"

previousstring or nullOptionalformat: "uri"