> 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.

# queuing.relay.tasks

GET /

Receive tasks delivered to a subscribed context

Reference: https://signalwire.com/docs/apis/relay/server/queuing/queuing-relay-tasks

## AsyncAPI Specification

```yaml
asyncapi: 2.6.0
info:
  title: queuing.relay.tasks
  version: subpackage_queuingRelayTasks.queuing.relay.tasks
  description: Receive tasks delivered to a subscribed context
channels:
  /:
    description: Receive tasks delivered to a subscribed context
    publish:
      operationId: subpackage_queuingRelayTasks.queuing.relay.tasks-publish
      summary: queuing.relay.tasks
      message:
        name: onQueuingRelayTasksTasksEvent
        title: queuing.relay.tasks
        payload:
          $ref: '#/components/schemas/queuing.relay.tasks_tasksEvent'
servers:
  production:
    url: wss://relay.signalwire.com/
    protocol: wss
    x-default: true
components:
  schemas:
    ChannelsQueuingRelayTasksMessagesTasksEventJsonrpc:
      type: string
      enum:
        - '2.0'
      description: JSON-RPC version. Always `2.0`.
      title: ChannelsQueuingRelayTasksMessagesTasksEventJsonrpc
    ChannelsQueuingRelayTasksMessagesTasksEventMethod:
      type: string
      enum:
        - signalwire.event
      description: Always `signalwire.event`.
      title: ChannelsQueuingRelayTasksMessagesTasksEventMethod
    ChannelsQueuingRelayTasksMessagesTasksEventParamsEventType:
      type: string
      enum:
        - queuing.relay.tasks
      description: The event type — identifies which event this is.
      title: ChannelsQueuingRelayTasksMessagesTasksEventParamsEventType
    ChannelsQueuingRelayTasksMessagesTasksEventParams:
      type: object
      properties:
        event_type:
          $ref: >-
            #/components/schemas/ChannelsQueuingRelayTasksMessagesTasksEventParamsEventType
          description: The event type — identifies which event this is.
        context:
          type: string
          description: The context this task arrived on.
        message:
          description: >-
            The message payload, exactly as the sender passed it to the Tasking
            REST

            endpoint. Any non-empty JSON value — usually an object, but an
            array, string,

            number, or `true` is delivered as-is. The sender is limited to 2000
            characters of

            serialized JSON.
        timestamp:
          type: integer
          format: int64
          description: >-
            When the event was emitted, as a Unix timestamp in seconds
            (integer).
        project_id:
          type: string
          description: Your project ID.
        space_id:
          type: string
          description: Your space ID.
      required:
        - event_type
        - context
        - message
        - timestamp
        - project_id
        - space_id
      description: The flat event envelope.
      title: ChannelsQueuingRelayTasksMessagesTasksEventParams
    queuing.relay.tasks_tasksEvent:
      type: object
      properties:
        jsonrpc:
          $ref: >-
            #/components/schemas/ChannelsQueuingRelayTasksMessagesTasksEventJsonrpc
          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/ChannelsQueuingRelayTasksMessagesTasksEventMethod
          description: Always `signalwire.event`.
        params:
          $ref: >-
            #/components/schemas/ChannelsQueuingRelayTasksMessagesTasksEventParams
          description: The flat event envelope.
      required:
        - jsonrpc
        - id
        - method
        - params
      description: >-
        Fires when a task arrives on a context you're subscribed to. The payload
        tells

        you which `context` the task came in on and carries the `message`
        exactly as

        the sender passed it to the Tasking REST endpoint (`POST
        /api/relay/rest/tasks`) —

        any non-empty JSON value, not necessarily an object.
      title: queuing.relay.tasks_tasksEvent

```