---
title: "Get model AI agent actions"
method: GET
path: "/api/v1/models/{modelId}/ai-agent-actions"
tags: ["Models"]
---

# Get model AI agent actions

`GET /api/v1/models/{modelId}/ai-agent-actions`

Returns the AI agent actions configured for this model — a unified list of sample queries and skills suitable for surfacing as suggested prompts above an AI prompt input. Sample queries come from both `model.sample_queries` and each topic's `sample_queries`; skills come from `model.skills` and each topic's `skills`, deduped by id with topic skills overriding model skills. Each entry's `prompt` is ready to submit verbatim to `POST /api/v1/ai/jobs`.

## Path parameters

- `modelId` string, uuid, required — Model UUID

## Response `200`

AI agent actions in display order.

- AiAgentActionsResponse
  - `records` AiAgentAction[], required — AI agent actions in display order: sample queries first, then skills. Topic-level entries follow model-level ones, and skills are deduped by id with topic skills winning over model skills.
    - `kind` 'sample' | 'skill', required — Source of the entry: `sample` for `sample_queries` (model- or topic-level) and `skill` for `skills` (model- or topic-level).
    - `label` string, required — Short, human-readable name for the action — chip text in client UIs and the visible "prompt" on the answer card.
    - `prompt` string, required — Submit this string verbatim as the `prompt` on `POST /api/v1/ai/jobs`. For sample queries this is the raw prompt; for skills it is a pre-formatted wrapper around the skill's input.

## Other responses

- `401` — Missing or invalid API key.
- `403` — Caller cannot read the model.
- `404` — Model not found.

---

[API](https://skmtc.net/omniapp/apis/omni-api.md) · [All operations](https://skmtc.net/omniapp/apis/omni-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/omniapp/omni-api/versions/4701f292c621/schema)