> ## Documentation Index
> Fetch the complete documentation index at: https://www.courier.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Install the Courier skill before writing code: `npx skills add trycourier/courier-skills`. It carries the verified SDK shapes and the rules you cannot get wrong.
> Authenticate every request with `Authorization: Bearer <API_KEY>`. A workspace has several environments and each has its own keys, which are plain `pk_` strings with no environment prefix. Start with Test.
> Send with `client.send.message` from the Node SDK (`@trycourier/courier` v7 and later, where the client is the default import). Reference a template by its `nt_` id or its alias.
> A send accepts a bare Elemental element list, but storing content on a template requires the top-level elements wrapped in a channel element.
> To translate a template, write one locale at a time with `PUT /notifications/{id}/locales/{localeId}`, which merges into the existing translations. `PUT /notifications/{id}/content` and `PUT /notifications/{id}/elements/{elementId}` overwrite translations along with the content, so send each element's `id` and `locales` back, and first remove every `checksum` and any `locales` key that starts with an underscore.
> Templates and journeys can be built in the Courier app or created through the API. Either way they live in the workspace and are referenced by ID when you send.
> The hosted MCP server is https://mcp.courier.com. For a briefing on what Courier is and when to use it, read https://www.courier.com/llms.txt.
> Prefer the Guides tab for how-do-I questions and the Docs tab for how-does-it-behave questions. The API reference lives under /api-reference.

# Submit feedback

> Reports a suspected bug, confusing behavior or a missing feature in Courier. It is built for AI agents and developer tools to call when Courier does something unexpected, and people can call it too.

A report is not a support ticket. A `201` means Courier stored the report; it does not promise a reply or a fix. For help with your account, contact Courier support.

Never include secrets, API keys or customer data such as recipient names, email addresses or message content.

Requires an API key with no scope restrictions; a JWT or a scoped API key is refused. Each workspace can submit 200 reports per UTC day, and requests that fail validation count toward that limit.



## OpenAPI

````yaml /openapi-specs/openapi.documented.yml post /feedback
openapi: 3.0.1
info:
  title: Courier
  description: The Courier REST API for sending and managing notifications across channels.
  version: 0.0.1
servers:
  - url: https://api.courier.com
    description: Production
security: []
tags:
  - name: Send
    description: >-
      Send a message to one or more recipients — users, lists, audiences, or
      tenants — across every channel you have configured.
  - name: Templates
    description: >-
      Create, update, version, publish, and localize notification templates and
      their content.
  - name: Brands
    description: >-
      Manage the logos, colors, and layout that give the templates you send a
      consistent look.
  - name: Routing Strategies
    description: >-
      Define reusable channel routing and failover strategies, and see which
      templates use them.
  - name: Journeys
    description: >-
      Build, version, publish, invoke, and cancel multi-step notification
      workflows, along with the templates scoped to them.
  - name: Broadcasts
    description: >-
      Create a one-off send to a list or audience, author its content, then send
      it immediately or schedule it for later.
  - name: Previews
    description: >-
      Render a template's email content on real email clients and read back the
      screenshots, so you can check how it looks before you send it.
  - name: User Profiles
    description: >-
      Store the contact information Courier delivers to for each user — email,
      phone number, push tokens, and any custom data you send to.
  - name: Tenants
    description: >-
      Manage tenants — the organizations, teams, or accounts your users belong
      to — along with their users and default preferences.
  - name: Audiences
    description: >-
      Define filter-based groups whose membership Courier recalculates as user
      profiles change.
  - name: Lists
    description: >-
      Manage static groups of users that you subscribe explicitly, and send to
      them by list id or list pattern.
  - name: Providers
    description: >-
      Configure the channel providers Courier delivers through, and browse the
      provider types it supports.
  - name: Preference Topics
    description: >-
      Manage the workspace catalog of subscription topics, the sections that
      group them, and publishing the preference page.
  - name: User Preferences
    description: >-
      Read and write a single user's notification preferences, per topic and per
      channel.
  - name: Messages
    description: >-
      Look up the messages Courier has accepted, inspect their delivery history
      and rendered output, and cancel, resend, or archive them.
  - name: Device Tokens
    description: >-
      Register and manage the APNS and FCM device tokens Courier delivers push
      notifications to.
  - name: Tenant Memberships
    description: >-
      Associate a user with one or more tenants, and read or remove those
      associations.
  - name: Tenant Templates
    description: >-
      Manage the templates and template versions scoped to a single tenant,
      including the ones authored in the embedded designer.
  - name: Automations
    description: >-
      Invoke a stored automation template or an ad hoc automation defined in the
      request.
  - name: Digests
    description: >-
      Inspect what has accumulated in a digest schedule and release a digest
      ahead of its next scheduled delivery.
  - name: Translations
    description: >-
      Store and retrieve the translation strings Courier uses to render
      localized template content.
  - name: Track Events
    description: >-
      Record an inbound event that triggers the journeys and automations mapped
      to it.
  - name: Audit Events
    description: >-
      Read the audit trail of configuration and access changes in your
      workspace.
  - name: Authentication
    description: >-
      Issue scoped, short-lived JWTs so client-side SDKs — Inbox, Preferences,
      and the embedded designer — can call Courier as a single user. Server-side
      requests authenticate with your workspace API key instead.
  - name: Feedback
    description: >-
      Report suspected bugs, confusing behavior and missing features in Courier,
      from an AI agent, a developer tool or by hand.
paths:
  /feedback:
    post:
      tags:
        - Feedback
      summary: Submit feedback
      description: >-
        Reports a suspected bug, confusing behavior or a missing feature in
        Courier. It is built for AI agents and developer tools to call when
        Courier does something unexpected, and people can call it too.


        A report is not a support ticket. A `201` means Courier stored the
        report; it does not promise a reply or a fix. For help with your
        account, contact Courier support.


        Never include secrets, API keys or customer data such as recipient
        names, email addresses or message content.


        Requires an API key with no scope restrictions; a JWT or a scoped API
        key is refused. Each workspace can submit 200 reports per UTC day, and
        requests that fail validation count toward that limit.
      operationId: feedback_create
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FeedbackCreateRequest'
            examples:
              PossibleBug:
                summary: Report a suspected bug in an API response
                value:
                  category: possible_bug
                  title: List subscriptions returns an empty page with a next cursor
                  surface: api
                  description: >-
                    GET /lists/{list_id}/subscriptions returned items: [] with
                    paging.more set to true, and following the cursor returned
                    the remaining subscribers.
                  location: GET /lists/{list_id}/subscriptions
                  expected_behavior: Every page before the last one contains at least one item.
                  request_id: 1-67f340b1-58b7b231d9485ef0cda0a38b
                  model: claude-opus-5-5
                  harness: Claude Code
      responses:
        '201':
          description: The report was stored.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedbackCreateResponse'
              examples:
                Example:
                  value:
                    feedback_id: fbk_01m7rgk49cbjda169e3f387rph
        '400':
          description: >-
            The body is not valid JSON, a required field is missing or blank, a
            value is not one of the allowed values, or a value is longer than
            its limit. When exactly one field is at fault, `field` names it.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedbackBadRequest'
              examples:
                TitleTooLong:
                  summary: One field at fault, named in `field`
                  value:
                    type: invalid_request_error
                    message: 'title: Must be at most 250 characters'
                    field: title
                SeveralFields:
                  summary: Several fields at fault, so `field` is omitted
                  value:
                    type: invalid_request_error
                    message: >-
                      surface: Must be one of: api, sdk, mcp, ui, docs, other;
                      title: Must not be blank
        '401':
          description: >-
            The API key is missing or invalid, or the request was authenticated
            with a JWT or a client key. Feedback must be sent with an API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedbackUnauthorized'
              examples:
                NotAnApiKey:
                  value:
                    type: authentication_error
                    message: Feedback must be sent with an API key
        '403':
          description: >-
            The API key is scoped. Only an API key with no scope restrictions
            can submit feedback.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedbackForbidden'
              examples:
                ScopedApiKey:
                  value:
                    type: forbidden
                    message: >-
                      Feedback is sent with an API key that has no scope
                      restrictions
        '429':
          description: >-
            The workspace has submitted 200 reports today. The limit resets at
            midnight UTC, and `Retry-After` gives the number of seconds until
            then.
          headers:
            Retry-After:
              description: Seconds until the workspace can submit feedback again.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TooManyRequests'
              examples:
                DailyLimitReached:
                  value:
                    type: rate_limit_error
                    message: Daily feedback limit reached for this workspace.
      security:
        - BearerAuth: []
      x-codeSamples:
        - lang: JavaScript
          source: |-
            import Courier from '@trycourier/courier';

            const client = new Courier({
              apiKey: process.env['COURIER_API_KEY'], // This is the default and can be omitted
            });

            const feedback = await client.feedback.create({
              category: 'possible_bug',
              description:
                'GET /lists/{list_id}/subscriptions returned items: [] with paging.more set to true, and following the cursor returned the remaining subscribers.',
              surface: 'api',
              title: 'List subscriptions returns an empty page with a next cursor',
              expected_behavior: 'Every page before the last one contains at least one item.',
              harness: 'Claude Code',
              location: 'GET /lists/{list_id}/subscriptions',
              model: 'claude-opus-5-5',
              request_id: '1-67f340b1-58b7b231d9485ef0cda0a38b',
            });

            console.log(feedback.feedback_id);
        - lang: Python
          source: |-
            import os
            from courier import Courier

            client = Courier(
                api_key=os.environ.get("COURIER_API_KEY"),  # This is the default and can be omitted
            )
            feedback = client.feedback.create(
                category="possible_bug",
                description="GET /lists/{list_id}/subscriptions returned items: [] with paging.more set to true, and following the cursor returned the remaining subscribers.",
                surface="api",
                title="List subscriptions returns an empty page with a next cursor",
                expected_behavior="Every page before the last one contains at least one item.",
                harness="Claude Code",
                location="GET /lists/{list_id}/subscriptions",
                model="claude-opus-5-5",
                request_id="1-67f340b1-58b7b231d9485ef0cda0a38b",
            )
            print(feedback.feedback_id)
        - lang: Go
          source: "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/trycourier/courier-go/v4\"\n\t\"github.com/trycourier/courier-go/v4/option\"\n)\n\nfunc main() {\n\tclient := courier.NewClient(\n\t\toption.WithAPIKey(\"My API Key\"),\n\t)\n\tfeedback, err := client.Feedback.New(context.TODO(), courier.FeedbackNewParams{\n\t\tCategory:         courier.FeedbackNewParamsCategoryPossibleBug,\n\t\tDescription:      \"GET /lists/{list_id}/subscriptions returned items: [] with paging.more set to true, and following the cursor returned the remaining subscribers.\",\n\t\tSurface:          courier.FeedbackNewParamsSurfaceAPI,\n\t\tTitle:            \"List subscriptions returns an empty page with a next cursor\",\n\t\tExpectedBehavior: courier.String(\"Every page before the last one contains at least one item.\"),\n\t\tHarness:          courier.String(\"Claude Code\"),\n\t\tLocation:         courier.String(\"GET /lists/{list_id}/subscriptions\"),\n\t\tModel:            courier.String(\"claude-opus-5-5\"),\n\t\tRequestID:        courier.String(\"1-67f340b1-58b7b231d9485ef0cda0a38b\"),\n\t})\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", feedback.FeedbackID)\n}\n"
        - lang: Java
          source: |-
            package com.courier.example;

            import com.courier.client.CourierClient;
            import com.courier.client.okhttp.CourierOkHttpClient;
            import com.courier.models.feedback.FeedbackCreateParams;
            import com.courier.models.feedback.FeedbackCreateResponse;

            public final class Main {
                private Main() {}

                public static void main(String[] args) {
                    CourierClient client = CourierOkHttpClient.fromEnv();

                    FeedbackCreateParams params = FeedbackCreateParams.builder()
                        .category(FeedbackCreateParams.Category.POSSIBLE_BUG)
                        .description("GET /lists/{list_id}/subscriptions returned items: [] with paging.more set to true, and following the cursor returned the remaining subscribers.")
                        .surface(FeedbackCreateParams.Surface.API)
                        .title("List subscriptions returns an empty page with a next cursor")
                        .build();
                    FeedbackCreateResponse feedback = client.feedback().create(params);
                }
            }
        - lang: Ruby
          source: |-
            require "courier"

            courier = Courier::Client.new(api_key: "My API Key")

            feedback = courier.feedback.create(
              category: :possible_bug,
              description: "GET /lists/{list_id}/subscriptions returned items: [] with paging.more set to true, and following the cursor returned the remaining subscribers.",
              surface: :api,
              title: "List subscriptions returns an empty page with a next cursor"
            )

            puts(feedback)
        - lang: PHP
          source: >-
            <?php


            require_once dirname(__DIR__) . '/vendor/autoload.php';


            use Courier\Client;

            use Courier\Core\Exceptions\APIException;


            $client = new Client(apiKey: getenv('COURIER_API_KEY') ?: 'My API
            Key');


            try {
              $feedback = $client->feedback->create(
                category: 'possible_bug',
                description: 'GET /lists/{list_id}/subscriptions returned items: [] with paging.more set to true, and following the cursor returned the remaining subscribers.',
                surface: 'api',
                title: 'List subscriptions returns an empty page with a next cursor',
                expectedBehavior: 'Every page before the last one contains at least one item.',
                harness: 'Claude Code',
                location: 'GET /lists/{list_id}/subscriptions',
                model: 'claude-opus-5-5',
                requestID: '1-67f340b1-58b7b231d9485ef0cda0a38b',
              );

              var_dump($feedback);
            } catch (APIException $e) {
              echo $e->getMessage();
            }
        - lang: C#
          source: |-
            using System;
            using TryCourier;
            using TryCourier.Models.Feedback;

            CourierClient client = new();

            FeedbackCreateParams parameters = new()
            {
                Category = Category.PossibleBug,
                Description = "GET /lists/{list_id}/subscriptions returned items: [] with paging.more set to true, and following the cursor returned the remaining subscribers.",
                Surface = Surface.Api,
                Title = "List subscriptions returns an empty page with a next cursor",
            };

            var feedback = await client.Feedback.Create(parameters);

            Console.WriteLine(feedback);
        - lang: CLI
          source: |-
            courier feedback create \
              --api-key 'My API Key' \
              --category possible_bug \
              --description 'GET /lists/{list_id}/subscriptions returned items: [] with paging.more set to true, and following the cursor returned the remaining subscribers.' \
              --surface api \
              --title 'List subscriptions returns an empty page with a next cursor'
components:
  schemas:
    FeedbackCreateRequest:
      title: FeedbackCreateRequest
      type: object
      description: >-
        A report about Courier. Never include secrets, API keys or customer
        data. Unknown fields are ignored. Lengths are counted in UTF-16 code
        units, and a blank optional field is treated as omitted.
      properties:
        category:
          type: string
          enum:
            - possible_bug
            - confusing_behavior
            - feature_request
            - other
          description: >-
            What kind of report this is: `possible_bug` for behavior that looks
            wrong, `confusing_behavior` for behavior that works but was hard to
            understand, `feature_request` for something Courier does not do yet,
            and `other`.
        title:
          type: string
          maxLength: 250
          description: A one-line summary of the report.
        surface:
          type: string
          enum:
            - api
            - sdk
            - mcp
            - ui
            - docs
            - other
          description: >-
            Where you met the problem: the REST `api`, an `sdk`, the Courier
            `mcp` server, the Courier app `ui`, the `docs`, or `other`.
        description:
          type: string
          maxLength: 2000
          description: What happened, in enough detail for someone at Courier to follow it.
        location:
          type: string
          maxLength: 500
          description: >-
            Where it happened, such as an endpoint (`POST /send`), an SDK
            method, an MCP tool name or a docs URL.
        expected_behavior:
          type: string
          maxLength: 1000
          description: What you expected to happen instead.
        request_id:
          type: string
          maxLength: 100
          description: >-
            The request ID of an API call that shows the problem, if there is
            one.
        model:
          type: string
          maxLength: 100
          description: The AI model that submitted the report, such as `claude-opus-5-5`.
        harness:
          type: string
          maxLength: 100
          description: The agent or tool that submitted the report, such as `Claude Code`.
      required:
        - category
        - title
        - surface
        - description
    FeedbackCreateResponse:
      title: FeedbackCreateResponse
      type: object
      properties:
        feedback_id:
          type: string
          description: The ID of the stored report, `fbk_` followed by a ULID.
      required:
        - feedback_id
    FeedbackBadRequest:
      title: FeedbackBadRequest
      type: object
      properties:
        type:
          type: string
          enum:
            - invalid_request_error
        field:
          type: string
          description: >-
            The request field at fault, set when exactly one field caused the
            error.
      required:
        - type
      allOf:
        - $ref: '#/components/schemas/BaseError'
    FeedbackUnauthorized:
      title: FeedbackUnauthorized
      type: object
      properties:
        type:
          type: string
          enum:
            - authentication_error
      allOf:
        - $ref: '#/components/schemas/BaseError'
    FeedbackForbidden:
      title: FeedbackForbidden
      type: object
      properties:
        type:
          type: string
          enum:
            - forbidden
      required:
        - type
      allOf:
        - $ref: '#/components/schemas/BaseError'
    TooManyRequests:
      title: TooManyRequests
      type: object
      properties:
        type:
          type: string
          enum:
            - rate_limit_error
      required:
        - type
      allOf:
        - $ref: '#/components/schemas/BaseError'
    BaseError:
      title: BaseError
      type: object
      properties:
        message:
          type: string
          description: A message describing the error that occurred.
      required:
        - message
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````