Skip to main content
POST
https://agent.usedari.com
/
skills
/
{org_id}
curl -X POST "https://agent.usedari.com/skills/my-org?folder=payments" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@login_flow.zip"

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "folder_id": "660e8400-e29b-41d4-a716-446655440000",
  "folder_name": "payments",
  "org_id": "my-org",
  "org_name": "My Organization",
  "name": "login_flow",
  "is_public": false,
  "config": null,
  "template_id": null,
  "created_at": "2025-01-15T10:30:00Z",
  "updated_at": "2025-01-15T10:30:00Z"
}
Uploads a new skill zip file. The folder is auto-created if it doesn’t exist. The skill name is derived from the zip filename (e.g., login_flow.zip becomes login_flow).

​
Path Parameters

​
org_id
string
required
Organization ID

​
Query Parameters

​
folder
string
required
Folder name. The folder is auto-created if it doesn’t exist.
​
is_public
boolean
default:"false"
Whether the skill should be publicly available

​
Headers

​
X-API-Key
string
required
Organization API key
​
Content-Type
string
required
Must be multipart/form-data

​
Request Body

​
file
file
required
Skill zip file (.zip, max 100MB)

​
Response Fields

​
id
string
UUID of the created skill
​
folder_id
string
UUID of the folder containing this skill
​
folder_name
string
Name of the folder containing this skill
​
org_id
string
Organization ID
​
org_name
string
Organization name
​
name
string
Skill name (derived from zip filename)
​
is_public
boolean
Whether the skill is publicly available
​
config
object
Skill configuration (null for uploaded skills)
​
template_id
string
Template ID (null for uploaded skills)
​
created_at
string
ISO 8601 creation timestamp
​
updated_at
string
ISO 8601 update timestamp
curl -X POST "https://agent.usedari.com/skills/my-org?folder=payments" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@login_flow.zip"

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "folder_id": "660e8400-e29b-41d4-a716-446655440000",
  "folder_name": "payments",
  "org_id": "my-org",
  "org_name": "My Organization",
  "name": "login_flow",
  "is_public": false,
  "config": null,
  "template_id": null,
  "created_at": "2025-01-15T10:30:00Z",
  "updated_at": "2025-01-15T10:30:00Z"
}

​
Error Responses

{
  "detail": "Skill 'login_flow' already exists in folder 'payments'"
}