Layero Deploy Sessions API

The deploy-sessions API from Layero — 3 operation(s) for deploy-sessions.

GitHub OpenAPI

Operations 3

POST /deploy-sessions Create Deploy Session #
POST /deploy-sessions/{session_id}/start Start Deploy Session #
GET /deploy-sessions/{session_id} Get Deploy Session #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/layero-ru:layero-ru-deploy-sessions-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

layero-ru-deploy-sessions-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Layero Deploy Sessions API
  version: 0.1.0
tags:
- name: deploy-sessions
paths:
  /deploy-sessions:
    post:
      tags:
      - deploy-sessions
      summary: Create Deploy Session
      description: 'Открыть сессию: резолв проекта, настройка, адрес для загрузки архива.'
      operationId: create_deploy_session_deploy_sessions_post
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeploySessionCreate'
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeploySessionOut'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /deploy-sessions/{session_id}/start:
    post:
      tags:
      - deploy-sessions
      summary: Start Deploy Session
      description: Архив залит — запустить сборку.
      operationId: start_deploy_session_deploy_sessions__session_id__start_post
      parameters:
      - name: session_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          title: Session Id
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - $ref: '#/components/schemas/DeploySessionStartIn'
              - type: 'null'
              title: Payload
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeploySessionStatusOut'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /deploy-sessions/{session_id}:
    get:
      tags:
      - deploy-sessions
      summary: Get Deploy Session
      operationId: get_deploy_session_deploy_sessions__session_id__get
      parameters:
      - name: session_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          title: Session Id
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeploySessionStatusOut'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ProjectOut:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        name:
          type: string
          title: Name
        slug:
          type: string
          title: Slug
        apex_hostname:
          type: string
          title: Apex Hostname
        organization:
          $ref: '#/components/schemas/OrganizationInline'
        repo_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Repo Url
        repo_full_name:
          anyOf:
          - type: string
          - type: 'null'
          title: Repo Full Name
        default_branch:
          type: string
          title: Default Branch
        source_type:
          type: string
          title: Source Type
          default: github
        source_provider:
          anyOf:
          - type: string
          - type: 'null'
          title: Source Provider
        github_integration_enabled:
          type: boolean
          title: Github Integration Enabled
          default: false
        cli_deploys_enabled:
          type: boolean
          title: Cli Deploys Enabled
          default: true
        redeploy_available:
          anyOf:
          - type: boolean
          - type: 'null'
          title: Redeploy Available
        framework_hint:
          anyOf:
          - type: string
          - type: 'null'
          title: Framework Hint
        build_cmd:
          anyOf:
          - type: string
          - type: 'null'
          title: Build Cmd
        output_dir:
          anyOf:
          - type: string
          - type: 'null'
          title: Output Dir
        start_cmd:
          anyOf:
          - type: string
          - type: 'null'
          title: Start Cmd
        port:
          anyOf:
          - type: integer
          - type: 'null'
          title: Port
        preset:
          anyOf:
          - $ref: '#/components/schemas/ProjectPresetOut'
          - type: 'null'
        package_manager:
          anyOf:
          - type: string
          - type: 'null'
          title: Package Manager
        node_version:
          anyOf:
          - type: string
          - type: 'null'
          title: Node Version
        root_directory:
          anyOf:
          - type: string
          - type: 'null'
          title: Root Directory
        cancel_superseded:
          type: boolean
          title: Cancel Superseded
          default: true
        auto_deploy_on_push:
          type: boolean
          title: Auto Deploy On Push
          default: true
        auto_deploy_paused_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Auto Deploy Paused At
        auto_deploy_pause_streak:
          anyOf:
          - type: integer
          - type: 'null'
          title: Auto Deploy Pause Streak
        auto_deploy_pause_deploy_id:
          anyOf:
          - type: string
            format: uuid
          - type: 'null'
          title: Auto Deploy Pause Deploy Id
        auto_deploy_pause_error:
          anyOf:
          - type: string
          - type: 'null'
          title: Auto Deploy Pause Error
        auto_deploy_pause_scope:
          anyOf:
          - type: string
          - type: 'null'
          title: Auto Deploy Pause Scope
        auth_enabled:
          type: boolean
          title: Auth Enabled
          default: false
        auth_realm_name:
          anyOf:
          - type: string
          - type: 'null'
          title: Auth Realm Name
        indexing_enabled:
          type: boolean
          title: Indexing Enabled
          default: false
        created_at:
          type: string
          format: date-time
          title: Created At
        has_in_flight:
          type: boolean
          title: Has In Flight
          default: false
        default_env_ready:
          type: boolean
          title: Default Env Ready
          default: false
        last_failed_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Last Failed At
        publish_status:
          type: string
          title: Publish Status
          default: unknown
        apex_cdn_ready:
          type: boolean
          title: Apex Cdn Ready
          default: false
        retired_hostnames:
          items:
            type: string
          type: array
          title: Retired Hostnames
          default: []
        retired_until:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Retired Until
        project_type:
          type: string
          title: Project Type
          default: spa
        fullstack_config:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Fullstack Config
        project_type_suggestion:
          anyOf:
          - type: string
          - type: 'null'
          title: Project Type Suggestion
        build_settings_suggestion:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Build Settings Suggestion
        runtime_instance_tier:
          anyOf:
          - type: string
          - type: 'null'
          title: Runtime Instance Tier
        status:
          type: string
          title: Status
          default: active
        repo_status:
          type: string
          title: Repo Status
          default: connected
        github_app_installation_id:
          anyOf:
          - type: integer
          - type: 'null'
          title: Github App Installation Id
        installation_state:
          anyOf:
          - type: string
          - type: 'null'
          title: Installation State
        my_role:
          type: string
          title: My Role
          default: viewer
        production_deploy_id:
          anyOf:
          - type: string
            format: uuid
          - type: 'null'
          title: Production Deploy Id
        previous_production_deploy_id:
          anyOf:
          - type: string
            format: uuid
          - type: 'null'
          title: Previous Production Deploy Id
        auto_promote_default_branch:
          type: boolean
          title: Auto Promote Default Branch
          default: true
        production_pointer_enabled:
          type: boolean
          title: Production Pointer Enabled
          default: false
        member_count:
          type: integer
          title: Member Count
          default: 1
        production_branch_name:
          anyOf:
          - type: string
          - type: 'null'
          title: Production Branch Name
        branding_enabled:
          type: boolean
          title: Branding Enabled
          default: true
        footer_color:
          anyOf:
          - type: string
          - type: 'null'
          title: Footer Color
        is_suspended:
          type: boolean
          title: Is Suspended
          default: false
        is_manually_suspended:
          type: boolean
          title: Is Manually Suspended
          default: false
        is_blocked:
          type: boolean
          title: Is Blocked
          default: false
        runtime_last_failure_reason:
          anyOf:
          - type: string
          - type: 'null'
          title: Runtime Last Failure Reason
        runtime_last_failed_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Runtime Last Failed At
        runtime_memory_advisory:
          anyOf:
          - type: string
          - type: 'null'
          title: Runtime Memory Advisory
        runtime_memory_advisory_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Runtime Memory Advisory At
        favicon_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Favicon Url
      type: object
      required:
      - id
      - name
      - slug
      - apex_hostname
      - organization
      - default_branch
      - created_at
      title: ProjectOut
    DeploySessionStartIn:
      properties:
        commit_sha:
          anyOf:
          - type: string
            maxLength: 64
            minLength: 6
          - type: 'null'
          title: Commit Sha
        confirm_repeated_failure:
          type: boolean
          title: Confirm Repeated Failure
          default: false
      type: object
      title: DeploySessionStartIn
      description: 'Тело старта.


        `commit_sha` обязателен, если сессия открывалась без него, — иначе

        сборке нечем дедуплицироваться и нечего записать в деплой.'
    ProjectPresetOut:
      properties:
        name:
          type: string
          title: Name
        label:
          type: string
          title: Label
        fields:
          items:
            type: string
          type: array
          title: Fields
        defaults:
          additionalProperties:
            anyOf:
            - type: string
            - type: 'null'
          type: object
          title: Defaults
          default: {}
        sources:
          additionalProperties:
            type: string
          type: object
          title: Sources
          default: {}
        start_candidates:
          items:
            type: string
          type: array
          title: Start Candidates
          default: []
        policy:
          additionalProperties:
            type: string
          type: object
          title: Policy
          default: {}
        has_ssr_switch:
          type: boolean
          title: Has Ssr Switch
          default: false
        env_prefix:
          anyOf:
          - type: string
          - type: 'null'
          title: Env Prefix
      type: object
      required:
      - name
      - label
      - fields
      title: ProjectPresetOut
      description: 'Договор фреймворка о сборке — в том виде, в каком его читает панель.


        Считается из `detection.spec.json` (`services/presets.py`), поэтому вторая

        рукописная таблица умолчаний в панели становится не нужна.'
    DeploySessionStatusOut:
      properties:
        session_id:
          type: string
          format: uuid
          title: Session Id
        status:
          type: string
          title: Status
        project_id:
          type: string
          format: uuid
          title: Project Id
        deploy_id:
          anyOf:
          - type: string
            format: uuid
          - type: 'null'
          title: Deploy Id
        created_project:
          type: boolean
          title: Created Project
        error:
          anyOf:
          - type: string
          - type: 'null'
          title: Error
      type: object
      required:
      - session_id
      - status
      - project_id
      - deploy_id
      - created_project
      - error
      title: DeploySessionStatusOut
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    DeploySessionOut:
      properties:
        session_id:
          type: string
          format: uuid
          title: Session Id
        project:
          $ref: '#/components/schemas/ProjectOut'
        created_project:
          type: boolean
          title: Created Project
        upload_url:
          type: string
          title: Upload Url
        upload_headers:
          additionalProperties:
            type: string
          type: object
          title: Upload Headers
        source_archive_key:
          type: string
          title: Source Archive Key
        expires_in:
          type: integer
          title: Expires In
      type: object
      required:
      - session_id
      - project
      - created_project
      - upload_url
      - upload_headers
      - source_archive_key
      - expires_in
      title: DeploySessionOut
    OrganizationInline:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        github_login:
          anyOf:
          - type: string
          - type: 'null'
          title: Github Login
        slug:
          type: string
          title: Slug
        kind:
          type: string
          title: Kind
          default: team
      type: object
      required:
      - id
      - slug
      title: OrganizationInline
    DeploySessionCreate:
      properties:
        project_id:
          anyOf:
          - type: string
            format: uuid
          - type: 'null'
          title: Project Id
        name:
          anyOf:
          - type: string
            maxLength: 60
            minLength: 1
          - type: 'null'
          title: Name
        organization_slug:
          anyOf:
          - type: string
          - type: 'null'
          title: Organization Slug
        address:
          anyOf:
          - type: string
            maxLength: 63
            minLength: 1
          - type: 'null'
          title: Address
        reuse_existing:
          type: boolean
          title: Reuse Existing
          default: true
        create_if_missing:
          type: boolean
          title: Create If Missing
          default: true
        target:
          anyOf:
          - type: string
            enum:
            - preview
            - production
          - type: 'null'
          title: Target
        branch:
          anyOf:
          - type: string
          - type: 'null'
          title: Branch
        promote:
          type: boolean
          title: Promote
          default: false
        prebuilt:
          type: boolean
          title: Prebuilt
          default: false
        framework_hint:
          anyOf:
          - type: string
            maxLength: 32
          - type: 'null'
          title: Framework Hint
        build_cmd:
          anyOf:
          - type: string
            maxLength: 512
          - type: 'null'
          title: Build Cmd
        output_dir:
          anyOf:
          - type: string
            maxLength: 256
          - type: 'null'
          title: Output Dir
        package_manager:
          anyOf:
          - type: string
            enum:
            - npm
            - yarn
            - pnpm
            - bun
          - type: 'null'
          title: Package Manager
        runtime_kind:
          anyOf:
          - type: string
            enum:
            - ssr_next
            - streamlit
            - gradio
            - flask
            - python_web
            - node_web
            - spa
          - type: 'null'
          title: Runtime Kind
        runtime_kind_origin:
          anyOf:
          - type: string
            enum:
            - user
            - detected
          - type: 'null'
          title: Runtime Kind Origin
        root_directory:
          anyOf:
          - type: string
            maxLength: 256
          - type: 'null'
          title: Root Directory
        env_vars:
          additionalProperties:
            type: string
          type: object
          title: Env Vars
        commit_sha:
          anyOf:
          - type: string
            maxLength: 64
            minLength: 6
          - type: 'null'
          title: Commit Sha
        commit_message:
          anyOf:
          - type: string
            maxLength: 512
          - type: 'null'
          title: Commit Message
      type: object
      title: DeploySessionCreate
      description: 'Намерение задеплоить.


        Либо `project_id` (проект уже известен клиенту — обычный повторный

        деплой), либо `name` (первый деплой из каталога). Одно из двух обязательно.'