---
title: "List directives"
method: GET
path: "/robots/v1/directives"
tags: ["Directives"]
---

# List directives

`GET /robots/v1/directives`

## Request

- Base URL: `https://api.mux.com`
- URL: `https://api.mux.com/robots/v1/directives`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

Returns active v0 and v1 directive summaries, newest first. Follow each self link to retrieve the owning-version configuration.

## Query parameters

- `limit` integer: Maximum number of results to return (default 25, max 100).
- `page` integer: Page number, 1-indexed (default 1).

## Response `200`

Directive summaries

- DirectiveListResponse
  - `data` DirectiveSummary[], required
    - `id` string, required: Opaque directive identifier (drv_...).
    - `name` string, required: Human-readable directive name.
    - `created_at` integer, required: Creation Unix timestamp in seconds.
    - `updated_at` integer, required: Last update Unix timestamp in seconds.
    - `_links` DirectiveLinks, required
      - `self` DirectiveSelfLink, required
        - `href` string, required: URL to the directive in its creation API version.
  - `total_row_count` integer, required

## Other responses

- `401`: Missing or invalid Mux credentials
- `403`: The access token lacks robots:read (insufficient_scope), or Robots access is inactive or suspended. For insufficient_scope, use credentials with the required permission. If using an API access token, create a replacement token with that permission. Enabling Robots for an organization does not grant token permissions.
- `422`: Invalid request parameters
- `500`: Server error

## Changes

- **2026-10-23** `ed6cb570d60c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/muxinc/apis/mux-api/changes/robots/v1/directives/get.md)

---

[API](https://skmtc.dev/muxinc/apis/mux-api.md) - [All operations](https://skmtc.dev/muxinc/apis/mux-api/llms.txt) - [OpenAPI document](https://skmtc.dev/muxinc/apis/mux-api/revisions/75b4251a1d96?raw)