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

# List catalog resources

> ListResources returns all resources of a kind for the tenant.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/catalog/{kind}
openapi: 3.0.0
info:
  title: Murmur REST API
  description: >-
    PRE-ALPHA: INTERFACE SUBJECT TO CHANGE WITHOUT NOTICE.


    The murmur REST API lets you spawn agents, track their progress, manage
    their task lists, and read and write catalog resources from any HTTP client.
  version: v1
servers:
  - url: https://api.murmur.dev
security:
  - ApiKey: []
tags:
  - name: MurmurService
paths:
  /v1/catalog/{kind}:
    get:
      tags:
        - MurmurService
      summary: List catalog resources
      description: ListResources returns all resources of a kind for the tenant.
      operationId: MurmurService_ListResources
      parameters:
        - name: kind
          in: path
          required: true
          schema:
            type: string
        - name: tenant.provider
          description: >-
            Identity provider of the tenant namespace (e.g. PROVIDER_GITHUB_APP
            for a GitHub org).
          in: query
          required: false
          schema:
            type: string
            enum:
              - PROVIDER_UNSPECIFIED
              - PROVIDER_GITHUB_OAUTH
              - PROVIDER_GITHUB_APP
              - PROVIDER_GOOGLE_OIDC
              - PROVIDER_SERVICE_PROFILE
            default: PROVIDER_UNSPECIFIED
        - name: tenant.org
          description: username or org name
          in: query
          required: false
          schema:
            type: string
        - name: prefix
          description: |-
            Optional name prefix filter. When set, only resources whose name
            starts with this prefix are returned. The caller must have list
            permission for this prefix (checked via name_pattern on the grant).
          in: query
          required: false
          schema:
            type: string
        - name: includeTombstoned
          description: >-
            When true, disabled platform builtins are included in items/names
            and flagged in tombstoned_builtin_names, so a settings UI can render
            them as "disabled, with undo". When false (the default), disabled
            builtins are omitted entirely.
          in: query
          required: false
          schema:
            type: boolean
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1ListResourcesResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/googleRpcStatus'
components:
  schemas:
    v1ListResourcesResponse:
      type: object
      properties:
        kind:
          type: string
        items:
          type: array
          items:
            type: string
            format: byte
          description: The resource documents, each as base64-encoded JSON.
        names:
          type: array
          items:
            type: string
          title: 'parallel to items: the resource name for each entry'
        builtinNames:
          type: array
          items:
            type: string
          title: names of platform-provided resources (subset of names)
        tombstonedBuiltinNames:
          type: array
          items:
            type: string
          description: >-
            Platform builtin names this tenant has disabled for this kind.
            Hidden from resolution — they do not appear in names or
            builtin_names — but surfaced here so a management UI can render them
            as "disabled" and offer re-enable.
    googleRpcStatus:
      type: object
      properties:
        code:
          type: integer
          format: int32
          description: >-
            Numeric status code for the failure, matching the HTTP status of the
            response via the standard mapping (e.g. 3 INVALID_ARGUMENT → 400, 5
            NOT_FOUND → 404, 7 PERMISSION_DENIED → 403, 16 UNAUTHENTICATED →
            401).
        message:
          type: string
          description: Human-readable description of what caused the failure.
        details:
          type: array
          items:
            $ref: '#/components/schemas/protobufAny'
          description: >-
            Machine-readable error details, when the failure carries them.
            Usually empty.
      description: The error envelope returned on every non-2xx response.
    protobufAny:
      type: object
      properties:
        '@type':
          type: string
          description: >-
            Identifies the payload type of this detail value; the remaining
            properties are that type's fields.
      additionalProperties: {}
      description: >-
        A structured detail value. `@type` identifies the payload type; the
        remaining properties are that type's fields.
  securitySchemes:
    ApiKey:
      type: http
      scheme: bearer
      description: 'murmur API key: mur_<key_id>.<secret>'

````