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

# Start a pending action

> Start the action identified by the URL. Both `cue_id` and `secret` are obtained from the action's `resolution_link.url`; the `secret` is a signed token bound to a member and expires 1 hour after it is issued.

The body must include the parameters listed in the action's `resolution_link.required_parameters`. The body and response shapes are action-specific — the documented schemas apply when the action's `code` is `reauthenticate`. Other action codes will use their own request/response shapes.

Once started, the action stays in progress until its outcome is reported via `/cues/{cue_id}/state`.



## OpenAPI

````yaml https://app.podero.com/api/partners/v2.0/openapi.json post /api/partners/v2.0/cues/{cue_id}/resolve
openapi: 3.1.0
info:
  title: Podero Partner API
  version: '2.0'
  description: >-
    This API provides a unified interaction point for Podero's partner
    companies.


    The goal of this API is to give partners easily integratable endpoints that
    don't require extensive software

    development. For this reason, the endpoints focus around user and device
    management, setting of preferences

    and high level device controls.


    While direct control of devices is implemented for special use cases such as
    pause power, we abstract away low level

    direct device steering so developers and partners can focus on delivering
    maximum value to end users.
  termsOfService: https://www.podero.com/terms-and-conditions
servers: []
security: []
paths:
  /api/partners/v2.0/cues/{cue_id}/resolve:
    post:
      tags:
        - Cues
      summary: Start a pending action
      description: >-
        Start the action identified by the URL. Both `cue_id` and `secret` are
        obtained from the action's `resolution_link.url`; the `secret` is a
        signed token bound to a member and expires 1 hour after it is issued.


        The body must include the parameters listed in the action's
        `resolution_link.required_parameters`. The body and response shapes are
        action-specific — the documented schemas apply when the action's `code`
        is `reauthenticate`. Other action codes will use their own
        request/response shapes.


        Once started, the action stays in progress until its outcome is reported
        via `/cues/{cue_id}/state`.
      operationId: integrations_api_api_v2_cues_router_resolve_cue
      parameters:
        - in: path
          name: cue_id
          schema:
            description: The action's ID
            format: uuid
            title: Cue Id
            type: string
          required: true
          description: The action's ID
        - in: query
          name: secret
          schema:
            description: Signed secret authorising the caller for this action
            title: Secret
            type: string
          required: true
          description: Signed secret authorising the caller for this action
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReauthenticateActionInput'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReauthenticateActionOutput'
      security:
        - OAuth2: []
components:
  schemas:
    ReauthenticateActionInput:
      description: >-
        Body shape for resolving an action whose `code` is `reauthenticate`.


        Other action codes will introduce their own input schemas — do not
        assume this

        schema applies to every action.
      properties:
        successUrl:
          description: >-
            URL the end-user should land on after the reauthentication completes
            successfully.
          title: Successurl
          type: string
        cancelUrl:
          description: >-
            URL the end-user should land on if they cancel or the
            reauthentication fails.
          title: Cancelurl
          type: string
        language:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Optional IETF language tag (e.g. `en`, `de`) used to localise the
            reauthentication UI.
          title: Language
        location:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          description: >-
            Optional caller location metadata recorded alongside the start
            event.
          title: Location
        clientInfo:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          description: >-
            Optional caller client metadata (user-agent, device, etc.) recorded
            alongside the start event.
          title: Clientinfo
      required:
        - successUrl
        - cancelUrl
      title: ReauthenticateActionInput
      type: object
    ReauthenticateActionOutput:
      description: Response shape for resolving an action whose `code` is `reauthenticate`.
      properties:
        redirect_url:
          description: >-
            URL the caller should redirect the end-user to in order to complete
            the reauthentication flow.
          title: Redirect Url
          type: string
      required:
        - redirect_url
      title: ReauthenticateActionOutput
      type: object
  securitySchemes:
    OAuth2:
      type: oauth2
      flows:
        password:
          tokenUrl: /api/partners/v2.0/auth/token
          scopes: {}
        clientCredentials:
          tokenUrl: /api/partners/v2.0/auth/token
          scopes: {}

````