Skip to content
Everruns Everruns

Create skill from ZIP archive

POST
/v1/skills/upload

Responses

Section titled “ Responses ”

201

Section titled “201 ”

Skill created from archive

Wrapper that adds self_url and view_url to a serialized resource.

Uses self_url (not url) for the API link to avoid collision with resources that already have a url field (e.g. McpServer).

object
allowed_tools
string | null
archived_at
string | null format: date-time
compatibility
string | null
created_at
required
string format: date-time
deleted_at
string | null format: date-time
description
required
string
Example
Extract text and tables from PDF files.
disable_model_invocation

Whether the model is prevented from auto-invoking this skill

boolean
id
required
string
Example
skill_01933b5a00007000800000000000001
license
string | null
metadata
object
key
additional properties
name
required
string
Example
pdf-processing
source_type
required

Skill source type

string
Allowed values: markdown archive
status
required

Skill lifecycle status

string
Allowed values: active disabled archived deleted
updated_at
required
string format: date-time
user_invocable

Whether this skill appears as a /slash command for users

boolean
version
required
string
self_url
required

Full API endpoint URL for this resource.

string
view_url
required

Full UI URL for viewing this resource.

string

409

Section titled “409 ”

Duplicate skill name

Standard error response for API endpoints.

object
error
required

Error message describing what went wrong.

string

413

Section titled “413 ”

Archive too large

Standard error response for API endpoints.

object
error
required

Error message describing what went wrong.

string

422

Section titled “422 ”

Invalid archive or SKILL.md

Standard error response for API endpoints.

object
error
required

Error message describing what went wrong.

string