2959
"/api/v3.1/session_configs": {
2960
"get": {
2961
"summary": "List Session configs",
2962
- "description": "List Session configs in your project, newest updated first. Returns active configs by default; set archived=true to list archived configs. Retrieve a config by ID for its description and toolkit, tool, and tag policy. Experimental: available only to projects enabled for Session configs. Create and manage configs in Dashboard.",
2962
+ "description": "List Session configs in your project, newest updated first. Returns active configs by default; set archived=true to list archived configs. Retrieve a config by ID for its description and toolkit, tool, and tag policy. Experimental. Create and manage configs in Dashboard.",
2963
"tags": [
2964
"Tool Router"
2965
],
3090
}
3091
},
3092
"403": {
3093
- "description": "Session configs or read access not enabled for this project.",
3093
+ "description": "Forbidden. The API key lacks Session management read access.",
3094
"content": {
3095
"application/json": {
3096
"schema": {
3126
"/api/v3.1/session_configs/{session_config_id}": {
3127
"get": {
3128
"summary": "Retrieve a Session config",
3129
- "description": "Retrieve a saved access policy in your project. config.toolkits.enable selects toolkit slugs; config.toolkits.disable excludes them; an omitted config.toolkits allows all toolkits. Tool and tag rules further restrict access. This returns the saved policy, not an expanded catalog or an existing Session snapshot. Archived configs remain readable but cannot create new Sessions. Experimental: available only to projects enabled for Session configs. Create and manage configs in Dashboard.",
3129
+ "description": "Retrieve a saved access policy in your project. config.toolkits.enable selects toolkit slugs; config.toolkits.disable excludes them; an omitted config.toolkits allows all toolkits. Tool and tag rules further restrict access. This returns the saved policy, not an expanded catalog or an existing Session snapshot. Archived configs remain readable but cannot create new Sessions. Experimental. Create and manage configs in Dashboard.",
3130
"tags": [
3131
"Tool Router"
3132
],
3473
}
3474
},
3475
"403": {
3476
- "description": "Session configs or read access not enabled for this project.",
3476
+ "description": "Forbidden. The API key lacks Session management read access.",
3477
"content": {
3478
"application/json": {
3479
"schema": {
4478
"/api/v3.1/tools/enum": {
4479
"get": {
4480
"summary": "Get tool enum list",
4481
- "description": "Retrieve a list of all available tool enumeration values (tool slugs) from latest version of each toolkit. This endpoint returns a comma-separated string of tool slugs that can be used in other API calls.",
4481
+ "description": "Lists the slug of every tool in the latest version of each Composio-managed toolkit, such as GMAIL_SEND_EMAIL. Tools of custom toolkits are not included.",
4482
"tags": [
4483
"Tools"
4484
],
4501
"items": {
4502
"type": "string"
4503
},
4504
- "description": "JSON string containing all tool enum values from latest version of each toolkit"
4504
+ "description": "Tool slugs"
4505
}
4506
}
4507
}
6542
"maxLength": 200,
6543
"description": "Display name of the toolkit"
6544
},
6545
- "app_url": {
6545
+ "mcp_url": {
6546
"type": "string",
6547
"format": "uri",
6548
"description": "MCP server URL. Must use https."
6717
},
6718
"required": [
6719
"name",
6720
- "app_url",
6720
+ "mcp_url",
6721
"auth_schemes",
6722
"user_id"
6723
],
7013
},
7014
"patch": {
7015
"summary": "Update a custom toolkit",
7016
- "description": "Experimental: this endpoint may change. Updates a custom toolkit's name, logo, or API key field text. Omitted fields keep their current value. To change app_url, auth_schemes, or user_id, delete and re-create the toolkit. On a project with 2FA enabled, updating a private toolkit requires the user_id it is private to.",
7016
+ "description": "Experimental: this endpoint may change. Updates a custom toolkit's name, logo, or API key field text. Omitted fields keep their current value. To change mcp_url, auth_schemes, or user_id, delete and re-create the toolkit. On a project with 2FA enabled, updating a private toolkit requires the user_id it is private to.",
7017
"tags": [
7018
"Toolkits"
7019
],
13264
}
13265
},
13266
"403": {
13267
- "description": "Session configs are not enabled for this project.",
13267
+ "description": "Forbidden. The caller cannot modify this Session.",
13268
"content": {
13269
"application/json": {
13270
"schema": {
18646
}
18647
}
18648
},
18649
+ "403": {
18650
+ "description": "Forbidden - Your role does not allow modifying auth configs",
18651
+ "content": {
18652
+ "application/json": {
18653
+ "schema": {
18654
+ "$ref": "#/components/schemas/Error"
18655
+ }
18656
+ }
18657
+ }
18658
+ },
18659
"404": {
18660
"description": "Not found - Auth configuration does not exist",
18661
"content": {
18769
}
18770
}
18771
},
18772
+ "403": {
18773
+ "description": "Forbidden - Your role does not allow modifying auth configs",
18774
+ "content": {
18775
+ "application/json": {
18776
+ "schema": {
18777
+ "$ref": "#/components/schemas/Error"
18778
+ }
18779
+ }
18780
+ }
18781
+ },
18782
"404": {
18783
"description": "Auth config not found - The specified configuration does not exist or was already deleted",
18784
"content": {
18889
}
18890
}
18891
},
18892
+ "403": {
18893
+ "description": "Forbidden - Your role does not allow modifying auth configs",
18894
+ "content": {
18895
+ "application/json": {
18896
+ "schema": {
18897
+ "$ref": "#/components/schemas/Error"
18898
+ }
18899
+ }
18900
+ }
18901
+ },
18902
"404": {
18903
"description": "Not found - Auth configuration does not exist",
18904
"content": {
23127
}
23128
}
23129
},
23130
+ "403": {
23131
+ "description": "Your role does not allow modifying webhook subscriptions",
23132
+ "content": {
23133
+ "application/json": {
23134
+ "schema": {
23135
+ "$ref": "#/components/schemas/Error"
23136
+ }
23137
+ }
23138
+ }
23139
+ },
23140
"409": {
23141
"description": "Subscription already exists",
23142
"content": {
23569
}
23570
}
23571
},
23572
+ "403": {
23573
+ "description": "Your role does not allow modifying webhook subscriptions",
23574
+ "content": {
23575
+ "application/json": {
23576
+ "schema": {
23577
+ "$ref": "#/components/schemas/Error"
23578
+ }
23579
+ }
23580
+ }
23581
+ },
23582
"404": {
23583
"description": "Subscription not found",
23584
"content": {
23656
}
23657
}
23658
},
23659
+ "403": {
23660
+ "description": "Your role does not allow modifying webhook subscriptions",
23661
+ "content": {
23662
+ "application/json": {
23663
+ "schema": {
23664
+ "$ref": "#/components/schemas/Error"
23665
+ }
23666
+ }
23667
+ }
23668
+ },
23669
"404": {
23670
"description": "Subscription not found",
23671
"content": {
23752
}
23753
}
23754
},
23755
+ "403": {
23756
+ "description": "Your role does not allow modifying webhook subscriptions",
23757
+ "content": {
23758
+ "application/json": {
23759
+ "schema": {
23760
+ "$ref": "#/components/schemas/Error"
23761
+ }
23762
+ }
23763
+ }
23764
+ },
23765
"404": {
23766
"description": "Subscription not found",
23767
"content": {
25063
"/api/v3.1/custom/toolkits/upsert": {
25064
"post": {
25065
"summary": "Upsert a custom toolkit",
24996
- "description": "Experimental: custom toolkits are in pilot and this contract may change. Creates a custom toolkit for the project with the provided slug, or updates its display metadata (name, API key field copy) when the project already owns a toolkit with that slug. A toolkit created here is shared with every user in the project; an existing toolkit keeps its access. app_url and auth_schemes cannot be changed on an existing toolkit: re-sending them unchanged is a no-op, changing them returns 409 (delete and re-register the toolkit instead, which revokes its connections).",
25066
+ "description": "Experimental: custom toolkits are in pilot and this contract may change. Creates a custom toolkit for the project with the provided slug, or updates its display metadata (name, API key field copy) when the project already owns a toolkit with that slug. A toolkit created here is shared with every user in the project; an existing toolkit keeps its access. mcp_url and auth_schemes cannot be changed on an existing toolkit: re-sending them unchanged is a no-op, changing them returns 409 (delete and re-register the toolkit instead, which revokes its connections).",
25067
"tags": [
25068
"Toolkits"
25069
],
25101
"maxLength": 200,
25102
"description": "Display name of the toolkit"
25103
},
25034
- "app_url": {
25104
+ "mcp_url": {
25105
"type": "string",
25106
"format": "uri",
25107
"description": "MCP server URL. Must use https."
25254
},
25255
"required": [
25256
"name",
25187
- "app_url",
25257
+ "mcp_url",
25258
"auth_schemes"
25259
],
25260
"additionalProperties": false
25331
}
25332
},
25333
"409": {
25264
- "description": "Conflict - app_url or auth_schemes differ from the registered toolkit; delete and re-register to change them",
25334
+ "description": "Conflict - mcp_url or auth_schemes differ from the registered toolkit; delete and re-register to change them",
25335
"content": {
25336
"application/json": {
25337
"schema": {
27342
}
27343
}
27344
},
27345
+ "403": {
27346
+ "description": "Forbidden",
27347
+ "content": {
27348
+ "application/json": {
27349
+ "schema": {
27350
+ "$ref": "#/components/schemas/Error"
27351
+ }
27352
+ }
27353
+ }
27354
+ },
27355
"404": {
27356
"description": "Trigger instance not found",
27357
"content": {
32866
"ApiKeyAuth": []
32867
}
32868
],
32869
+ "parameters": [
32870
+ {
32871
+ "schema": {
32872
+ "type": "string",
32873
+ "minLength": 1,
32874
+ "maxLength": 256,
32875
+ "description": "[EXPERIMENTAL] Include the custom toolkits this user can use. Without it, only custom toolkits with access \"all\" are included.",
32876
+ "example": "user_123",
32877
+ "x-experimental": true
32878
+ },
32879
+ "required": false,
32880
+ "description": "[EXPERIMENTAL] Include the custom toolkits this user can use. Without it, only custom toolkits with access \"all\" are included.",
32881
+ "name": "user_id",
32882
+ "in": "query"
32883
+ }
32884
+ ],
32885
"responses": {
32886
"200": {
32887
"description": "Toolkits changelog retrieved successfully",