Skip to main content
Version: 1.39.0

Seqera API

The Seqera Platform services API is a programmatic interface for all operations available in the Platform web UI. This allows organizations to integrate Platform seamlessly into existing processes.

Authentication

Security Scheme Type:

http

HTTP Authorization Scheme:

bearer

Bearer format:

jwt

info

The API requires authentication with a Platform access token to perform requests.

Create an access token

OpenAPI specification

Download OpenAPI schema file

The API and its interactive reference documentation is built on the OpenAPI standard.

tip

For more information on the OpenAPI standard, see OpenAPI.

API versioning

The API uses the semantic versioning convention (major.minor.patch). In the event that a breaking change is introduced in future versions, we will publish guidance on the v1 support schedule and steps to mitigate disruption to your production environment. The following do not constitute breaking changes:

  • Adding new API endpoints, new HTTP methods to existing endpoints, request parameters, or response fields
  • Adding new values to existing enums or string constants
  • Expanding accepted input formats or value ranges
  • Adding new optional headers or query parameters
  • Improving error messages or adding new error codes
  • Deprecation warnings (without removal)

Clients should be designed to gracefully handle unknown enum values, ignore unrecognized response fields, and not rely on specific error message text.

Encoding and formatting standards

  • For Seqera Cloud accounts, the API can be accessed from https://api.cloud.seqera.io.
  • All API endpoints use HTTPS, and all request and response payloads use JSON encoding.
  • All timestamps use the ISO 8601 date-time standard format: YYYY-MM-DDTHH:MM:SSZ.
note

From version 23.4, the Platform API is live on https://api.cloud.seqera.io. The legacy API https://api.tower.nf remains fully operational, so existing API integrations will continue to perform as expected. Deprecation of the legacy API will be communicated well in advance to avoid any breaking changes to your integrations.

Programmatic API

Both the Seqera Platform CLI and seqerakit are built on the Platform API and provide a programmatic automation layer for operations.

You can also use tools such as openapi-python-client to generate your own programmatic API for a particular language (such as Python) based on the OpenAPI schema. However, we do not guarantee that any OpenAPI client generators will work with the Platform API.