Skills

Create a workspace skill

Changed on

Creates a new skill in the workspace named in the path. Mutating public API requests support an optional Idempotency-Key header for client retries; duplicate keys within two hours return idempotency_duplicate.

post/workspaces/{workspaceId}/skills

Request

  • Base URL
    https://app.flora.ai/api/v1
  • URL
    https://app.flora.ai/api/v1/workspaces/{workspaceId}/skills
  • Auth
    HTTP bearer

Path parameters

workspaceIdstring required

Workspace identifier

Example:ws_abc123

Request body

namestring required

Skill name

descriptionstring required

Skill description

bodystring required

Skill body

thumbnail_video_urlstring

Skill thumbnail video URL

thumbnail_image_urlstring

Skill thumbnail image URL

Example request

{
  "name": "Brand Voice",
  "description": "Writes in our brand voice.",
  "body": "# Brand Voice\nWrite warmly and plainly."
}

Response

Skill created.

skill_idstring required

Skill identifier

workspace_idstring required

Workspace identifier

slugstring required

Skill URL slug

namestring required

Skill name

descriptionstring required

Skill description

thumbnail_video_urlstring

Skill thumbnail video URL

thumbnail_image_urlstring

Skill thumbnail image URL

Example response

{
  "skill_id": "skill_abc123",
  "workspace_id": "ws_abc123",
  "slug": "brand-voice",
  "name": "Brand Voice",
  "description": "Writes in our brand voice."
}

Changes

    • warning

      added the new not_configured enum value to the / response property for the response status

    • warning

      added the new not_configured enum value to the / response property for the response status

    • warning

      added the new not_configured enum value to the / response property for the response status

    • warning

      added the new not_configured enum value to the / response property for the response status

    • warning

      added the new not_configured enum value to the / response property for the response status

    • warning

      added the new not_configured enum value to the / response property for the response status

    • warning

      added the new not_configured enum value to the / response property for the response status

    • warning

      added the new not_configured enum value to the / response property for the response status

    • warning

      added the new not_configured enum value to the / response property for the response status

    • info

      endpoint added