# HTTP Connector Endpoints
## List HTTP Connector Endpoints for a connector resource
> Returns a list of endpoints for the given HTTP Connector and HTTP Connector Resource.
```json
{"openapi":"3.1.0","info":{"title":"HTTP Connector Endpoints","version":"1.0.0"},"servers":[{"url":"https://api.integrator.io","description":"Production (US / default region)"},{"url":"https://api.eu.integrator.io","description":"Production (EU region)"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"Response":{"type":"object","description":"HTTP Connector Endpoint object as returned by the API","allOf":[{"$ref":"#/components/schemas/Request"},{"$ref":"#/components/schemas/ResourceResponse"},{"$ref":"#/components/schemas/IAResourceResponse"},{"type":"object","properties":{"_id":{"type":"string","format":"objectId","description":"Unique identifier for the HTTP Connector Endpoint","readOnly":true},"_userId":{"type":"string","format":"objectId","description":"Owner user id","readOnly":true},"createdAt":{"type":"string","format":"date-time","description":"Timestamp when created","readOnly":true},"lastModified":{"type":"string","format":"date-time","description":"Timestamp when last modified","readOnly":true},"deletedAt":{"type":"string","format":"date-time","description":"Timestamp when soft-deleted (if applicable)","readOnly":true}}}]},"Request":{"type":"object","description":"Fields that can be sent when creating or updating an HTTP Connector Endpoint","properties":{"name":{"type":"string","description":"Human-readable name for this endpoint","maxLength":255},"description":{"type":"string","description":"Optional endpoint description","maxLength":10240},"published":{"type":"boolean","description":"Whether this endpoint is published"},"isBlob":{"type":"boolean","description":"Whether this endpoint is a blob endpoint","default":false},"isMappingRequired":{"type":"boolean","description":"Whether mapping is required for this endpoint","default":false},"_httpConnectorResourceIds":{"type":"array","description":"References to HTTP Connector Resources associated with this endpoint","items":{"type":"string","format":"objectId"}},"method":{"type":"string","enum":["GET","PUT","POST","PATCH","DELETE"],"description":"HTTP method for this endpoint"},"relativeURI":{"type":"string","description":"Relative URI template for this endpoint"},"mergePostBodyToPagingPostBody":{"type":"boolean","description":"Whether to merge postBody into pagingPostBody","default":false},"queryParameters":{"type":"array","description":"Query parameter definitions","items":{"type":"object","properties":{"name":{"type":"string"},"label":{"type":"string"},"description":{"type":"string"},"required":{"type":"boolean"},"dataType":{"type":"string","enum":["input","date","select","multiselect","array","number"]},"values":{"type":"array","items":{"type":"string"}}},"required":["name","label"]}},"pathParameters":{"type":"array","description":"Path parameter definitions","items":{"type":"object","properties":{"name":{"type":"string"},"label":{"type":"string"},"description":{"type":"string"},"required":{"type":"boolean"},"dataType":{"type":"string","enum":["input","date","select","multiselect","array","number"]},"values":{"type":"array","items":{"type":"string"}}},"required":["name","label"]}},"resourceFields":{"type":"array","description":"Resource field definitions for this endpoint","items":{"type":"object","properties":{"type":{"type":"string","enum":["inclusion","exclusion"]},"fields":{"type":"array","items":{"type":"string"}},"_httpConnectorResourceId":{"type":"string","format":"objectId"}},"required":["type","fields","_httpConnectorResourceId"]}},"supportedBy":{"type":"object","description":"Supported-by configuration for this endpoint (framework-defined)","properties":{"type":{"type":"string","enum":["import","export"]},"conditions":{"type":"array","items":{"type":"object","additionalProperties":true}},"preConfiguredFields":{"type":"array","items":{"type":"object","additionalProperties":true}},"fieldsUserMustSet":{"type":"array","items":{"type":"object","additionalProperties":true}},"fieldsToUnset":{"type":"array","items":{"type":"string"}},"pathParameterToIdentifyExisting":{"type":"string"},"lookupToIdentifyExisting":{"type":"object","properties":{"_httpConnectorEndpointId":{"type":"string","format":"objectId"},"extract":{"type":"string"}}}}}},"required":["name","method","relativeURI"]},"ResourceResponse":{"type":"object","description":"Core response fields shared by all Celigo resources","properties":{"_id":{"type":"string","format":"objectId","readOnly":true,"description":"Unique identifier for the resource.\n\nThe _id is used in:\n- API endpoints that operate on a specific resource (e.g., GET, PUT, DELETE)\n- References from other resources (e.g., flows that use this resource)\n- Job history and error tracking\n\nFormat: 24-character hexadecimal string\n"},"createdAt":{"type":"string","format":"date-time","readOnly":true,"description":"Timestamp indicating when the resource was initially created.\n\nThis read-only field is automatically set during resource creation and cannot\nbe modified. It provides an audit trail for when the resource was first added\nto the system, which can be useful for:\n\n- Resource lifecycle management\n- Audit and compliance reporting\n- Troubleshooting integration timelines\n- Identifying older resources that may need review\n\nThe timestamp is recorded in ISO 8601 format with UTC timezone (Z suffix).\n"},"lastModified":{"type":"string","format":"date-time","readOnly":true,"description":"Timestamp indicating when the resource was most recently updated.\n\nThis read-only field is automatically updated whenever any property of the\nresource is modified. It provides an audit trail that can be used for:\n\n- Determining if a resource has changed since it was last reviewed\n- Monitoring configuration changes during troubleshooting\n- Implementing cache invalidation strategies\n- Synchronizing related resources based on modification time\n\nThe timestamp is recorded in ISO 8601 format with UTC timezone (Z suffix)\nand will always be equal to or later than the createdAt timestamp.\n"},"deletedAt":{"type":["string","null"],"format":"date-time","readOnly":true,"description":"Timestamp indicating when the resource was marked for deletion.\n\nWhen this field is present and contains a valid timestamp, it indicates\nthat the resource has been soft-deleted (moved to the recycle bin) but not\nyet permanently removed from the system. This allows for recovery of\naccidentally deleted resources within a specified retention period.\n\nThe deletedAt timestamp enables:\n- Filtering deleted resources from active resource listings\n- Implementing time-based retention policies for permanent deletion\n- Tracking deletion events for audit and compliance purposes\n- Resource recovery workflows with clear timeframes\n\nThe timestamp is recorded in ISO 8601 format with UTC timezone (Z suffix).\nWhen null or absent, the resource is considered active.\n"}},"required":["_id"]},"IAResourceResponse":{"type":"object","description":"Integration app response fields for resources that are part of integration apps","properties":{"_integrationId":{"type":"string","format":"objectId","readOnly":true,"description":"Reference to the specific integration instance that contains this resource.\n\nThis field is only populated for resources that are part of an integration app\ninstallation. It contains the unique identifier (_id) of the integration\nresource that was installed in the account.\n\nThe integration instance represents a specific installed instance of an\nintegration app, with its own configuration, settings, and runtime environment.\n\nThis reference enables:\n- Tracing the resource back to its parent integration instance\n- Permission and access control based on integration ownership\n- Lifecycle management (enabling/disabling, updating, or uninstalling)\n"},"_connectorId":{"type":"string","format":"objectId","readOnly":true,"description":"Reference to the integration app that defines this resource.\n\nThis field is only populated for resources that are part of an integration app.\nIt contains the unique identifier (_id) of the integration app (connector)\nthat defines the structure, behavior, and templates for this resource.\n\nThe integration app is the published template that can be installed\nmultiple times across different accounts, with each installation creating\na separate integration instance (referenced by _integrationId).\n\nThis reference enables:\n- Identifying the source integration app for this resource\n- Determining which template version is being used\n- Linking to documentation, support, and marketplace information\n"}}},"Error":{"type":"object","description":"Standard error response envelope returned by integrator.io APIs.","properties":{"errors":{"type":"array","description":"List of errors that occurred while processing the request.","items":{"type":"object","properties":{"code":{"oneOf":[{"type":"string"},{"type":"integer"}],"description":"Machine-readable error code. Usually a string like\n`invalid_ref`, `missing_required_field`, or `unauthorized`;\nmay be an **integer** when the error mirrors an upstream HTTP\nstatus (e.g. `500`) — most commonly returned by connection-ping\nand adaptor-proxy responses."},"message":{"type":"string","description":"Human-readable description of the error."},"field":{"type":"string","description":"Optional pointer to the document field that caused the error.\nUsed by structural validation errors (`missing_required_field`,\n`invalid_ref`) to indicate which field is at fault\n(e.g. `_id`, `type`, `http.baseURI`)."},"source":{"type":"string","description":"Optional origin layer for the error — e.g. `application` when\nthe error came from the remote system the adaptor called,\n`connector` when the adaptor itself rejected the request."}},"required":["message"]}}},"required":["errors"]}},"responses":{"401-unauthorized":{"description":"Unauthorized. The request lacks a valid bearer token, or the provided token\nfailed to authenticate.\n\nNote: the 401 response is produced by the auth middleware **before** the\nrequest reaches the endpoint handler, so it does **not** follow the\nstandard `{errors: [...]}` envelope. Instead the body is a bare\n`{message: string}` object with no `code`, no `errors` array. Callers\nhandling 401s should key off the HTTP status and the `message` string,\nnot try to destructure an `errors[]`.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable description of the auth failure. Known values:\n- `\"Unauthorized\"` — no `Authorization` header on the request.\n- `\"Bearer Authentication Failed\"` — header present but token\n is invalid, revoked, or expired."}},"required":["message"]}}}},"404-not-found":{"description":"Not found. The requested resource does not exist or is not visible to the caller.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/v1/httpconnectors/{_httpConnectorId}/{_httpConnectorResourceId}/httpconnectorendpoints":{"get":{"summary":"List HTTP Connector Endpoints for a connector resource","description":"Returns a list of endpoints for the given HTTP Connector and HTTP Connector Resource.\n","operationId":"listHttpConnectorEndpoints","tags":["HTTP Connector Endpoints"],"parameters":[{"in":"path","name":"_httpConnectorId","required":true,"schema":{"type":"string"},"description":"HTTP Connector id"},{"in":"path","name":"_httpConnectorResourceId","required":true,"schema":{"type":"string"},"description":"HTTP Connector Resource id"},{"in":"query","name":"supportedByType","schema":{"type":"string"},"description":"Optional filter for supportedBy.type (import/export)"},{"in":"query","name":"publishedOnly","schema":{"type":"boolean"},"description":"Optional filter for published endpoints only"}],"responses":{"200":{"description":"Successfully retrieved list of HTTP Connector Endpoints","headers":{"Link":{"description":"RFC-5988 pagination links. When more pages remain, includes a `<...>; rel=\"next\"` entry;\nabsent on the final page.\n","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Response"}}}}},"204":{"description":"No endpoints exist for this resource"},"401":{"$ref":"#/components/responses/401-unauthorized"},"404":{"$ref":"#/components/responses/404-not-found"}}}}}}
```
## Get an HTTP connector endpoint
> Retrieves a specific HTTP Connector Endpoint by its unique identifier.
```json
{"openapi":"3.1.0","info":{"title":"HTTP Connector Endpoints","version":"1.0.0"},"servers":[{"url":"https://api.integrator.io","description":"Production (US / default region)"},{"url":"https://api.eu.integrator.io","description":"Production (EU region)"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"Response":{"type":"object","description":"HTTP Connector Endpoint object as returned by the API","allOf":[{"$ref":"#/components/schemas/Request"},{"$ref":"#/components/schemas/ResourceResponse"},{"$ref":"#/components/schemas/IAResourceResponse"},{"type":"object","properties":{"_id":{"type":"string","format":"objectId","description":"Unique identifier for the HTTP Connector Endpoint","readOnly":true},"_userId":{"type":"string","format":"objectId","description":"Owner user id","readOnly":true},"createdAt":{"type":"string","format":"date-time","description":"Timestamp when created","readOnly":true},"lastModified":{"type":"string","format":"date-time","description":"Timestamp when last modified","readOnly":true},"deletedAt":{"type":"string","format":"date-time","description":"Timestamp when soft-deleted (if applicable)","readOnly":true}}}]},"Request":{"type":"object","description":"Fields that can be sent when creating or updating an HTTP Connector Endpoint","properties":{"name":{"type":"string","description":"Human-readable name for this endpoint","maxLength":255},"description":{"type":"string","description":"Optional endpoint description","maxLength":10240},"published":{"type":"boolean","description":"Whether this endpoint is published"},"isBlob":{"type":"boolean","description":"Whether this endpoint is a blob endpoint","default":false},"isMappingRequired":{"type":"boolean","description":"Whether mapping is required for this endpoint","default":false},"_httpConnectorResourceIds":{"type":"array","description":"References to HTTP Connector Resources associated with this endpoint","items":{"type":"string","format":"objectId"}},"method":{"type":"string","enum":["GET","PUT","POST","PATCH","DELETE"],"description":"HTTP method for this endpoint"},"relativeURI":{"type":"string","description":"Relative URI template for this endpoint"},"mergePostBodyToPagingPostBody":{"type":"boolean","description":"Whether to merge postBody into pagingPostBody","default":false},"queryParameters":{"type":"array","description":"Query parameter definitions","items":{"type":"object","properties":{"name":{"type":"string"},"label":{"type":"string"},"description":{"type":"string"},"required":{"type":"boolean"},"dataType":{"type":"string","enum":["input","date","select","multiselect","array","number"]},"values":{"type":"array","items":{"type":"string"}}},"required":["name","label"]}},"pathParameters":{"type":"array","description":"Path parameter definitions","items":{"type":"object","properties":{"name":{"type":"string"},"label":{"type":"string"},"description":{"type":"string"},"required":{"type":"boolean"},"dataType":{"type":"string","enum":["input","date","select","multiselect","array","number"]},"values":{"type":"array","items":{"type":"string"}}},"required":["name","label"]}},"resourceFields":{"type":"array","description":"Resource field definitions for this endpoint","items":{"type":"object","properties":{"type":{"type":"string","enum":["inclusion","exclusion"]},"fields":{"type":"array","items":{"type":"string"}},"_httpConnectorResourceId":{"type":"string","format":"objectId"}},"required":["type","fields","_httpConnectorResourceId"]}},"supportedBy":{"type":"object","description":"Supported-by configuration for this endpoint (framework-defined)","properties":{"type":{"type":"string","enum":["import","export"]},"conditions":{"type":"array","items":{"type":"object","additionalProperties":true}},"preConfiguredFields":{"type":"array","items":{"type":"object","additionalProperties":true}},"fieldsUserMustSet":{"type":"array","items":{"type":"object","additionalProperties":true}},"fieldsToUnset":{"type":"array","items":{"type":"string"}},"pathParameterToIdentifyExisting":{"type":"string"},"lookupToIdentifyExisting":{"type":"object","properties":{"_httpConnectorEndpointId":{"type":"string","format":"objectId"},"extract":{"type":"string"}}}}}},"required":["name","method","relativeURI"]},"ResourceResponse":{"type":"object","description":"Core response fields shared by all Celigo resources","properties":{"_id":{"type":"string","format":"objectId","readOnly":true,"description":"Unique identifier for the resource.\n\nThe _id is used in:\n- API endpoints that operate on a specific resource (e.g., GET, PUT, DELETE)\n- References from other resources (e.g., flows that use this resource)\n- Job history and error tracking\n\nFormat: 24-character hexadecimal string\n"},"createdAt":{"type":"string","format":"date-time","readOnly":true,"description":"Timestamp indicating when the resource was initially created.\n\nThis read-only field is automatically set during resource creation and cannot\nbe modified. It provides an audit trail for when the resource was first added\nto the system, which can be useful for:\n\n- Resource lifecycle management\n- Audit and compliance reporting\n- Troubleshooting integration timelines\n- Identifying older resources that may need review\n\nThe timestamp is recorded in ISO 8601 format with UTC timezone (Z suffix).\n"},"lastModified":{"type":"string","format":"date-time","readOnly":true,"description":"Timestamp indicating when the resource was most recently updated.\n\nThis read-only field is automatically updated whenever any property of the\nresource is modified. It provides an audit trail that can be used for:\n\n- Determining if a resource has changed since it was last reviewed\n- Monitoring configuration changes during troubleshooting\n- Implementing cache invalidation strategies\n- Synchronizing related resources based on modification time\n\nThe timestamp is recorded in ISO 8601 format with UTC timezone (Z suffix)\nand will always be equal to or later than the createdAt timestamp.\n"},"deletedAt":{"type":["string","null"],"format":"date-time","readOnly":true,"description":"Timestamp indicating when the resource was marked for deletion.\n\nWhen this field is present and contains a valid timestamp, it indicates\nthat the resource has been soft-deleted (moved to the recycle bin) but not\nyet permanently removed from the system. This allows for recovery of\naccidentally deleted resources within a specified retention period.\n\nThe deletedAt timestamp enables:\n- Filtering deleted resources from active resource listings\n- Implementing time-based retention policies for permanent deletion\n- Tracking deletion events for audit and compliance purposes\n- Resource recovery workflows with clear timeframes\n\nThe timestamp is recorded in ISO 8601 format with UTC timezone (Z suffix).\nWhen null or absent, the resource is considered active.\n"}},"required":["_id"]},"IAResourceResponse":{"type":"object","description":"Integration app response fields for resources that are part of integration apps","properties":{"_integrationId":{"type":"string","format":"objectId","readOnly":true,"description":"Reference to the specific integration instance that contains this resource.\n\nThis field is only populated for resources that are part of an integration app\ninstallation. It contains the unique identifier (_id) of the integration\nresource that was installed in the account.\n\nThe integration instance represents a specific installed instance of an\nintegration app, with its own configuration, settings, and runtime environment.\n\nThis reference enables:\n- Tracing the resource back to its parent integration instance\n- Permission and access control based on integration ownership\n- Lifecycle management (enabling/disabling, updating, or uninstalling)\n"},"_connectorId":{"type":"string","format":"objectId","readOnly":true,"description":"Reference to the integration app that defines this resource.\n\nThis field is only populated for resources that are part of an integration app.\nIt contains the unique identifier (_id) of the integration app (connector)\nthat defines the structure, behavior, and templates for this resource.\n\nThe integration app is the published template that can be installed\nmultiple times across different accounts, with each installation creating\na separate integration instance (referenced by _integrationId).\n\nThis reference enables:\n- Identifying the source integration app for this resource\n- Determining which template version is being used\n- Linking to documentation, support, and marketplace information\n"}}},"Error":{"type":"object","description":"Standard error response envelope returned by integrator.io APIs.","properties":{"errors":{"type":"array","description":"List of errors that occurred while processing the request.","items":{"type":"object","properties":{"code":{"oneOf":[{"type":"string"},{"type":"integer"}],"description":"Machine-readable error code. Usually a string like\n`invalid_ref`, `missing_required_field`, or `unauthorized`;\nmay be an **integer** when the error mirrors an upstream HTTP\nstatus (e.g. `500`) — most commonly returned by connection-ping\nand adaptor-proxy responses."},"message":{"type":"string","description":"Human-readable description of the error."},"field":{"type":"string","description":"Optional pointer to the document field that caused the error.\nUsed by structural validation errors (`missing_required_field`,\n`invalid_ref`) to indicate which field is at fault\n(e.g. `_id`, `type`, `http.baseURI`)."},"source":{"type":"string","description":"Optional origin layer for the error — e.g. `application` when\nthe error came from the remote system the adaptor called,\n`connector` when the adaptor itself rejected the request."}},"required":["message"]}}},"required":["errors"]}},"responses":{"401-unauthorized":{"description":"Unauthorized. The request lacks a valid bearer token, or the provided token\nfailed to authenticate.\n\nNote: the 401 response is produced by the auth middleware **before** the\nrequest reaches the endpoint handler, so it does **not** follow the\nstandard `{errors: [...]}` envelope. Instead the body is a bare\n`{message: string}` object with no `code`, no `errors` array. Callers\nhandling 401s should key off the HTTP status and the `message` string,\nnot try to destructure an `errors[]`.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable description of the auth failure. Known values:\n- `\"Unauthorized\"` — no `Authorization` header on the request.\n- `\"Bearer Authentication Failed\"` — header present but token\n is invalid, revoked, or expired."}},"required":["message"]}}}},"403-forbidden":{"description":"Forbidden. The authenticated caller does not have permission to perform this operation.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404-not-found":{"description":"Not found. The requested resource does not exist or is not visible to the caller.\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/v1/httpconnectors/{_httpConnectorId}/{_httpConnectorResourceId}/{_id}":{"get":{"summary":"Get an HTTP connector endpoint","description":"Retrieves a specific HTTP Connector Endpoint by its unique identifier.\n","operationId":"getHttpConnectorEndpointById","tags":["HTTP Connector Endpoints"],"parameters":[{"in":"path","name":"_httpConnectorId","required":true,"schema":{"type":"string"},"description":"HTTP Connector id"},{"in":"path","name":"_httpConnectorResourceId","required":true,"schema":{"type":"string"},"description":"HTTP Connector Resource id"},{"in":"path","name":"_id","required":true,"schema":{"type":"string"},"description":"HTTP Connector Endpoint id"}],"responses":{"200":{"description":"HTTP Connector Endpoint retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response"}}}},"401":{"$ref":"#/components/responses/401-unauthorized"},"403":{"$ref":"#/components/responses/403-forbidden"},"404":{"$ref":"#/components/responses/404-not-found"}}}}}}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://developer.celigo.com/api/api-reference/http-connector-endpoints.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.