---
title: "List redacted executor registrations"
method: GET
path: "/v1/executors"
tags: ["Executors"]
---

# List redacted executor registrations

`GET /v1/executors`

## Request

- Base URL: `https://api.thrd.email`
- URL: `https://api.thrd.email/v1/executors`
- Auth: API key in header `x-admin-token`

Requires a server-authenticated tenant owner/operator with executors:manage. Agent API keys are rejected even if they contain a similarly named scope. Credential hashes and plaintext are never returned.

## Response `200`

Tenant-bound executor registrations

- object
  - `executors` object[], required
    - `principal_id` string, required
    - `environment` 'development' | 'staging' | 'production', required
    - `name` string, required
    - `tool_name` string, required
    - `execution_target` string, required
    - `status` 'active' | 'revoked' | 'disabled', required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `revoked_at` string, date-time, nullable, required
    - `credentials` object[], required
      - `credential_id` string, required
      - `status` 'active' | 'revoked' | 'disabled', required
      - `created_at` string, date-time, required
      - `expires_at` string, date-time, nullable, required
      - `last_used_at` string, date-time, nullable, required
      - `revoked_at` string, date-time, nullable, required

## Other responses

- `403`: Human manager authority unavailable
- `429`: Management rate limit exceeded
- `503`: Management authority unavailable

---

[API](https://skmtc.dev/thrd/apis/thrd-agent-email-api.md) · [All operations](https://skmtc.dev/thrd/apis/thrd-agent-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thrd/apis/thrd-agent-email-api/revisions/d8a88129cd34?raw)