Agent Control

Create an agent skill

POST
/api/v2/projects/{projectKey}/ai-configs/skills

Create a new agent skill within the given project.

Authorization

ApiKey read, write
Authorization<token>

In: header

Scope: read, write

Path Parameters

projectKey*string

Request Body

application/json

Agent skill object to create

key*string
name*string
description?string
markdown*string

The verbatim SKILL.md content of the agent skill

maintainerId?string
maintainerTeamKey?string
tags?array<string>

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/v2/projects/string/ai-configs/skills" \  -H "Content-Type: application/json" \  -d '{    "maintainerId": "507f1f77bcf86cd799439011",    "name": "name",    "markdown": "markdown",    "maintainerTeamKey": "example-team-key",    "description": "description",    "key": "key",    "tags": [      "tags",      "tags"    ]  }'
{  "createdAt": 6,  "_maintainer": {    "kind": "kind"  },  "_access": {    "allowed": [      {        "reason": {          "role_name": "role_name",          "notActions": [            null,            null          ],          "notResources": [            "notResources",            "notResources"          ],          "effect": "allow",          "resources": [            "proj/*:env/*;qa_*:/flag/*"          ],          "actions": [            "*"          ]        },        "action": "action"      },      {        "reason": {          "role_name": "role_name",          "notActions": [            null,            null          ],          "notResources": [            "notResources",            "notResources"          ],          "effect": "allow",          "resources": [            "proj/*:env/*;qa_*:/flag/*"          ],          "actions": [            "*"          ]        },        "action": "action"      }    ],    "denied": [      {        "reason": {          "role_name": "role_name",          "notActions": [            null,            null          ],          "notResources": [            "notResources",            "notResources"          ],          "effect": "allow",          "resources": [            "proj/*:env/*;qa_*:/flag/*"          ],          "actions": [            "*"          ]        },        "action": "action"      },      {        "reason": {          "role_name": "role_name",          "notActions": [            null,            null          ],          "notResources": [            "notResources",            "notResources"          ],          "effect": "allow",          "resources": [            "proj/*:env/*;qa_*:/flag/*"          ],          "actions": [            "*"          ]        },        "action": "action"      }    ]  },  "_links": {    "parent": {      "href": "href",      "type": "type"    },    "self": {      "href": "href",      "type": "type"    }  },  "name": "name",  "markdown": "markdown",  "description": "description",  "version": 0,  "key": "key",  "tags": [    "tags",    "tags"  ]}