---
title: "List learned skills"
method: GET
path: "/api/memories/skills"
tags: ["Memories"]
---

# List learned skills

`GET /api/memories/skills`

## Request

- Base URL: `https://aximo.autify.com`
- URL: `https://aximo.autify.com/api/memories/skills`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/autify/apis/aximo-api/docs/api/memories/skills/get.ts> (a function with typed inputs; its response is checked against the schema)

The reusable instructions the agent assembles workflows from, most-used
first, each listing the workflows it belongs to. Cursored the same way as
`GET /api/memories/workflows`.

## Query parameters

- `projectId` string, uuid, required
- `platform` 'desktop' | 'android' | 'ios'
- `appIdentifier` string
- `limit` integer
- `cursor` string

## Response `200`

A page of skills.

- object
  - `items` MemorySkill[], required
    - `id` string, uuid, required
    - `title` string, required
    - `template` string, required: The instruction, with `[[name]]` placeholders.
    - `placeholders` string[], required
    - `platform` 'desktop' | 'android' | 'ios', required
    - `appIdentifier` string, nullable
    - `nSucc` integer, required
    - `nUsed` integer, required
    - `lastUsedAt` string, date-time, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `usedByWorkflows` MemoryWorkflowRef[], required: The workflows this skill belongs to, by title.
      - `id` string, uuid, required
      - `title` string, required
  - `nextCursor` string

## Other responses

- `400`: Invalid query parameters or an undecodable cursor.
- `401`: Missing or invalid API key.
- `403`: API key is not scoped to an organization, the user is banned, or the user is no longer a member of the organization.
- `404`: The workspace does not exist in your organization.
- `429`: Rate limit exceeded — e.g. the daily session limit was reached for the organization, or too many API requests were sent in a short window (retry after the number of seconds in the `Retry-After` header).
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/autify/apis/aximo-api.md) - [All operations](https://skmtc.dev/autify/apis/aximo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/autify/apis/aximo-api/revisions/590722011284?raw)