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

# Get model AI agent actions

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

Return AI agent actions configured for a model — a unified list of sample queries and skills suitable for surfacing as suggested prompts in AI interfaces.

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.

When no actions are configured at the model or topic level, `records` returns an empty array.

## Path parameters

- `modelId` string, uuid, required

## Response `200`

AI agent actions retrieved successfully

- object
  - `success` boolean — Indicates the request was successful
  - `records` object[] — List of AI agent actions (sample queries and skills) configured for the model.
    - `type` 'sample_query' | 'skill', required — The type of action.
    - `id` string, required — Unique identifier for the action.
    - `label` string, required — Display label for the action.
    - `description` string, required — Description of what the action does.
    - `prompt` string, required — The prompt text to submit to the [Create AI job endpoint](/api/ai/create-ai-job). For skills, this is pre-formatted with the skill envelope.

## Other responses

- `400` — Bad Request Possible error messages: - `modelId: Invalid UUID`
- `403` — Forbidden Possible error messages: - `Permission denied`
- `404` — Not Found Possible error messages: - `Model with id <modelId> does not exist`
- `429` — Too Many Requests - Rate limit exceeded (60 requests/minute)

---

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