Authentik Policies API

Policies and policy bindings.

OpenAPI Specification

authentik-policies-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: authentik Core Policies API
  description: 'Best-effort OpenAPI 3.1 description of the authentik identity provider''s REST

    API (v3). authentik exposes a fully OpenAPI-driven REST surface at

    /api/v3 with browsable docs at /api/v3/ on each instance and a generated

    OpenAPI schema at /api/v3/schema/. Derived from public docs at

    https://docs.goauthentik.io/developer-docs/api/.

    '
  version: '3'
  contact:
    name: authentik developer docs
    url: https://docs.goauthentik.io/developer-docs/api/
servers:
- url: https://{authentik_host}/api/v3
  description: authentik instance API root
  variables:
    authentik_host:
      default: authentik.company
      description: Hostname of your authentik deployment
security:
- tokenAuth: []
- sessionAuth: []
tags:
- name: Policies
  description: Policies and policy bindings.
paths:
  /policies/all/:
    get:
      tags:
      - Policies
      summary: List policies
      operationId: policiesAllList
      responses:
        '200':
          description: Policies returned
  /policies/bindings/:
    get:
      tags:
      - Policies
      summary: List policy bindings
      operationId: policiesBindingsList
      responses:
        '200':
          description: Policy bindings returned
components:
  securitySchemes:
    tokenAuth:
      type: apiKey
      in: header
      name: Authorization
      description: 'authentik token authentication. Use header

        `Authorization: Bearer <token>` with a token created in the

        Tokens & App Passwords section.

        '
    sessionAuth:
      type: apiKey
      in: cookie
      name: authentik_session
      description: Browser session cookie for interactive use.