GunSpec

Docs

Resource class for the documentation endpoints. Instantiated internally by the GunSpec client and exposed as client.docs.

Auth RequiredExplorer+

Look up what the reference documents for an operation: parameters, the plan it needs, caching, every failure with its error.reason values, and the languages a sample is printed in.

getOperations(params: GetDocsOperationsParams): Promise<APIResponse<DocsOperations>>
GET/v1/docs/operations

  • stringheaderrequired

    Your API key. Authorization: Bearer <key> is accepted in its place.

  • stringrequired

    The operation's path: a documented template, a concrete path or a full URL. A path that names no operation is matched as a prefix.

    Max length
    300
    Example
  • string

    Narrow to one HTTP method. Omitted returns every method the path answers.

    Accepts
    Example

  • object

    The response payload.

  • string

    exact when the path named an operation, prefix when it did not and these are the operations under it (at most 25).

  • string

    The version of this document the reference was rendered from.

  • object[]

    The matching operations.

  • string

    HTTP method.

  • string

    The documented path template.

  • string

    The operation's title in the reference.

  • string

    What the operation does, as the reference states it.

  • string

    The lowest plan that may call it: public, account (a key attached to a user account), explorer, builder, studio or enterprise.

  • string

    Whether a key is required, optional or not used (none).

  • boolean

    Whether it answers 304 Not Modified to an If-None-Match carrying the ETag it sent.

  • string

    The operation's page in the reference.

  • object[]

    Path, query and header parameters, as the reference lists them.

  • object | null

    The request body, or null for an operation that takes none.

  • object

    What success looks like.

  • object[]

    Every failure the operation documents.

  • 400VALIDATION_ERRORValidation error
  • 401UNAUTHORIZEDAPI key required
  • 403FORBIDDENValid key, not permitted
  • 404NOT_FOUNDResource not found
  • 429RATE_LIMITEDRate limit exceeded
  • 500INTERNAL_ERRORUnexpected server error

Minimum tier
Explorer+
Monthly quota
200/mo
Rate limit
10/min
Daily cap
50

Figures shown are for this endpoint's minimum tier. Higher tiers raise every limit.