--- updatedAt: 2025-02-19T23:44:59.000Z agentTools: projectIndex: https://documentation.safecube.ai/llms.txt --- # List Endpoints List the application's endpoints. # OpenAPI definition ```json { "openapi": "3.0.0", "info": { "title": "Webhook api", "version": "1.2.1", "description": "Welcome to the documentation of Webhook API\n

Compatibility guidelines

The HTTP API is versioned with a single number, which is currently 1

This number symbolizes the major version number. New features can be added to the API in the same version number if there is no breaking change.

The version number is present in the url, for instance /webhook/api/v1 for the current version.

Please notice that all \"/shipment\" endpoints are deprecated. Therefore it is recommended to use the \"/easy-shipment\" endpoints.

\n

Documentation, Pricing and Key generation

You can find the complete documentation for our API at Developers Platform.

Create an account to receive your FREE key in under a minute!

Additionally, explore our pricing plans, access support, view detailed documentation, and follow our comprehensive tutorials.

\n

Authentication

Every endpoints of this API require authentication using an API key.

If you don't have an API Key and you need to use the Ports and Vessels API, you need to ask Sinay to have one.

To use the API Key, you must add a header named API_KEY with your API Key as a value.

Test the API with Swagger-ui

To test the API using Swagger-ui, you must click on the button Authorize and then fill the apiKey field and click on Authorize.

Swagger-ui will then use the api key automatically in each request.

On every endpoints, you can click on Try it out, you can modify the body and then click on Execute

You will be able to see the response.

\n

Release note

1.2.0

1.1.0

1.0.0

" }, "servers": [ { "url": "https://api.sinay.ai/webhook/api/v1" } ], "security": [ { "ApiKey": [] } ], "tags": [ { "name": "Endpoint", "description": "Endpoints are the URLs messages will be sent to. Endpoints must be configured with filters to setup which events you wish to track with them." } ], "paths": { "/endpoint": { "get": { "tags": [ "Endpoint" ], "summary": "List Endpoints", "description": "List the application's endpoints.", "operationId": "v1.endpoint.list", "parameters": [ { "in": "query", "name": "limit", "description": "Limit the number of returned items", "schema": { "description": "Limit the number of returned items", "type": "integer", "format": "uint64", "maximum": 250, "minimum": 1 }, "style": "form" }, { "in": "query", "name": "iterator", "description": "The iterator returned from a prior invocation", "schema": { "description": "The iterator returned from a prior invocation", "type": "string", "example": "ep_1srOrx2ZWZBpBUvZwXKQmoEYga2", "nullable": true }, "style": "form" }, { "in": "query", "name": "order", "description": "The sorting order of the returned items", "schema": { "description": "The sorting order of the returned items", "$ref": "#/components/schemas/Ordering", "nullable": true }, "style": "form" } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListResponse_EndpointOut_" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HttpErrorOut" } } } }, "404": { "description": "Not Found. No application found.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HttpErrorOut" } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HttpErrorOut" } } } }, "500": { "description": "Internal Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HttpErrorOut" } } } } } } } }, "components": { "schemas": { "HttpErrorOut": { "title": "HttpError", "type": "object", "required": [ "code", "detail" ], "properties": { "code": { "type": "string" }, "detail": { "type": "string" } } }, "Ordering": { "description": "Defines the ordering in a listing of results.", "type": "string", "enum": [ "ascending", "descending" ] }, "EndpointOut": { "type": "object", "required": [ "createdAt", "description", "id", "metadata", "updatedAt", "url", "version" ], "properties": { "id": { "description": "The ep's ID", "type": "string", "example": "ep_1srOrx2ZWZBpBUvZwXKQmoEYga2" }, "metadata": { "description": "Optional additional properties for your endpoint.", "type": "object", "additionalProperties": { "type": "string" } }, "description": { "description": "An example endpoint name", "type": "string" }, "rateLimit": { "description": "Rate limit of your endpoint in messages per second. This is an advanced field. Be aware that setting a low rateLimit can lead to a congestion queue and create delay in webhooks.", "type": "integer", "format": "uint16", "minimum": 0, "nullable": true }, "uid": { "description": "Optional unique identifier for the endpoint", "type": "string", "maxLength": 256, "minLength": 1, "pattern": "^[a-zA-Z0-9\\-_.]+$", "example": "unique-ep-identifier", "nullable": true }, "url": { "description": "Public url in your services where you plan to receive our webhooks. If you don't have a public url ready yet, you can use Svix play to test our webhooks https://www.svix.com/play/", "type": "string", "format": "uri", "example": "https://example.com/webhook/" }, "version": { "deprecated": true, "type": "integer", "format": "int32", "minimum": 1, "example": 1 }, "disabled": { "description": "When disabled is true, no messages will be sent to your endpoint. This can be used to deactivate a development or a testing endpoint when not in use.", "default": false, "type": "boolean", "example": false }, "filterTypes": { "type": "array", "items": { "description": "List of webhooks you wish to receive. Complete and up-to-date list of supported webhooks is available https://www.svix.com/event-types/eu/org_2VwHMERd77Ne7QX11CHCWBUSb1u/", "type": "string", "maxLength": 256, "pattern": "^[a-zA-Z0-9\\-_.]+$", "example": "shipment.added.to.endpoint" }, "minItems": 1, "uniqueItems": true, "nullable": true, "example": [ "shipment.added.to.endpoint", "container.new.event.detected" ] }, "channels": { "description": "List of message channels this endpoint listens to (omit for all)", "type": "array", "items": { "type": "string", "maxLength": 128, "pattern": "^[a-zA-Z0-9\\-_.]+$", "example": "project_1337" }, "maxItems": 10, "minItems": 1, "uniqueItems": true, "nullable": true, "example": [ "project_123", "group_2" ] }, "createdAt": { "type": "string", "format": "date-time", "example": "2024-01-12T14:43:13.993727Z" }, "updatedAt": { "type": "string", "format": "date-time", "example": "2024-01-12T14:43:13.993727Z" } } }, "ListResponse_EndpointOut_": { "type": "object", "required": [ "data", "done" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/EndpointOut" } }, "iterator": { "type": "string", "nullable": true, "example": "iterator" }, "prevIterator": { "type": "string", "nullable": true, "example": "-iterator" }, "done": { "type": "boolean" } } } }, "securitySchemes": { "ApiKey": { "type": "apiKey", "in": "header", "name": "API_KEY" } } } } ```