> This page is for APIs.

> Fetch clean Markdown by appending `.md` to any page URL under https://signalwire.com/docs or requesting it with the HTTP header `Accept: text/markdown`. The root index at https://signalwire.com/docs/llms.txt lists the available documentation indexes.

# signalwire.authorization.state

GET /

Receive authorization-state updates

Reference: https://signalwire.com/docs/apis/relay/client/signalwire/signalwire-authorization-state

## AsyncAPI Specification

```yaml
asyncapi: 2.6.0
info:
  title: signalwire.authorization.state
  version: subpackage_signalwireAuthorizationState.signalwire.authorization.state
  description: Receive authorization-state updates
channels:
  /:
    description: Receive authorization-state updates
    publish:
      operationId: >-
        subpackage_signalwireAuthorizationState.signalwire.authorization.state-publish
      summary: signalwire.authorization.state
      message:
        name: onSignalwireAuthorizationStateAuthorizationStateEvent
        title: signalwire.authorization.state
        payload:
          $ref: >-
            #/components/schemas/signalwire.authorization.state_authorizationStateEvent
servers:
  production:
    url: wss://relay.signalwire.com/
    protocol: wss
    x-default: true
components:
  schemas:
    ChannelsSignalwireAuthorizationStateMessagesAuthorizationStateEventJsonrpc:
      type: string
      enum:
        - '2.0'
      description: JSON-RPC version. Always `2.0`.
      title: >-
        ChannelsSignalwireAuthorizationStateMessagesAuthorizationStateEventJsonrpc
    ChannelsSignalwireAuthorizationStateMessagesAuthorizationStateEventMethod:
      type: string
      enum:
        - signalwire.event
      description: Always `signalwire.event`.
      title: >-
        ChannelsSignalwireAuthorizationStateMessagesAuthorizationStateEventMethod
    ChannelsSignalwireAuthorizationStateMessagesAuthorizationStateEventParamsEventType:
      type: string
      enum:
        - signalwire.authorization.state
      description: The event type — identifies which event this is.
      title: >-
        ChannelsSignalwireAuthorizationStateMessagesAuthorizationStateEventParamsEventType
    Signalwire.AuthorizationStateParams:
      type: object
      properties:
        authorization_state:
          type: string
          description: >-
            Your current authorization state — an opaque string. Save it and
            pass it back

            unchanged as `connect.authorization_state` when you reconnect.
      required:
        - authorization_state
      description: >-
        The payload of a `signalwire.authorization.state` event, carrying your
        latest authorization state.
      title: Signalwire.AuthorizationStateParams
    ChannelsSignalwireAuthorizationStateMessagesAuthorizationStateEventParams:
      type: object
      properties:
        event_type:
          $ref: >-
            #/components/schemas/ChannelsSignalwireAuthorizationStateMessagesAuthorizationStateEventParamsEventType
          description: The event type — identifies which event this is.
        params:
          $ref: '#/components/schemas/Signalwire.AuthorizationStateParams'
          description: The event-specific payload.
      required:
        - event_type
        - params
      description: The event envelope.
      title: >-
        ChannelsSignalwireAuthorizationStateMessagesAuthorizationStateEventParams
    signalwire.authorization.state_authorizationStateEvent:
      type: object
      properties:
        jsonrpc:
          $ref: >-
            #/components/schemas/ChannelsSignalwireAuthorizationStateMessagesAuthorizationStateEventJsonrpc
          description: JSON-RPC version. Always `2.0`.
        id:
          type: string
          description: >-
            Event id — a unique UUID generated for each event. Events are
            notifications: you do not reply to them.
        method:
          $ref: >-
            #/components/schemas/ChannelsSignalwireAuthorizationStateMessagesAuthorizationStateEventMethod
          description: Always `signalwire.event`.
        params:
          $ref: >-
            #/components/schemas/ChannelsSignalwireAuthorizationStateMessagesAuthorizationStateEventParams
          description: The event envelope.
      required:
        - jsonrpc
        - id
        - method
        - params
      description: >-
        Delivers your latest authorization state so you can restore it if you

        reconnect. Save the `authorization_state` value each time this event
        arrives.

        The envelope carries only `event_type` and `params`.
      title: signalwire.authorization.state_authorizationStateEvent

```