Layero Deploy Sessions API
The deploy-sessions API from Layero — 3 operation(s) for deploy-sessions.
The deploy-sessions API from Layero — 3 operation(s) for deploy-sessions.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/layero-ru:layero-ru-deploy-sessions-api"
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.
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: 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` (первый деплой из каталога). Одно из двух обязательно.'