create_endpoint
Create new API endpoints by defining HTTP methods, URLs, headers, and documentation to organize and manage your API catalog within designated folders.
Instructions
Create a new endpoint in a folder
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Endpoint name (required) | |
| method | Yes | HTTP method (required) | |
| url | Yes | Endpoint URL (required) | |
| folder_id | Yes | Folder ID to create endpoint in (required) | |
| description | No | Endpoint description (optional) | |
| headers | No | Request headers as key-value pairs | |
| body | No | Request body (JSON string) | |
| purpose | No | Business purpose - what this endpoint does (optional) | |
| request_params | No | Parameter documentation: {param_name: "description"} | |
| response_schema | No | Response field documentation: {field_name: "description"} | |
| header_docs | No | Header documentation: {header_name: "description"} |
Input Schema (JSON Schema)
{
"properties": {
"body": {
"description": "Request body (JSON string)",
"type": "string"
},
"description": {
"description": "Endpoint description (optional)",
"type": "string"
},
"folder_id": {
"description": "Folder ID to create endpoint in (required)",
"type": "string"
},
"header_docs": {
"additionalProperties": {
"description": "Header description",
"type": "string"
},
"description": "Header documentation: {header_name: \"description\"}",
"type": "object"
},
"headers": {
"additionalProperties": {
"description": "Header value",
"type": "string"
},
"description": "Request headers as key-value pairs",
"type": "object"
},
"method": {
"description": "HTTP method (required)",
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"HEAD",
"OPTIONS"
],
"type": "string"
},
"name": {
"description": "Endpoint name (required)",
"type": "string"
},
"purpose": {
"description": "Business purpose - what this endpoint does (optional)",
"type": "string"
},
"request_params": {
"additionalProperties": {
"description": "Parameter description",
"type": "string"
},
"description": "Parameter documentation: {param_name: \"description\"}",
"type": "object"
},
"response_schema": {
"additionalProperties": {
"description": "Response field description",
"type": "string"
},
"description": "Response field documentation: {field_name: \"description\"}",
"type": "object"
},
"url": {
"description": "Endpoint URL (required)",
"type": "string"
}
},
"required": [
"name",
"method",
"url",
"folder_id"
],
"type": "object"
}