CrewAI Cloud · Arazzo Workflow

CrewAI AMP Discover Inputs and Kick Off

Version 1.0.0

Discover the inputs a crew expects, then launch an execution with them.

1 workflow 1 source API 1 provider
View Spec View on GitHub AI AgentsAI Agent PlatformAgent OrchestrationMulti-Agent SystemsAgent Management PlatformManaged AgentsAutomationsObservabilityHuman In The LoopArazzoWorkflows

Provider

crewai-cloud

Workflows

discover-inputs-and-kickoff
List the crew's required input names, then kick off an execution.
Calls GET /inputs to discover the input parameter names the crew expects, then calls POST /kickoff with the caller-supplied inputs object to launch an execution and capture the kickoff_id.
2 steps inputs: bearerToken, crewWebhookUrl, inputs, meta outputs: kickoffId, requiredInputs
1
listRequiredInputs
listInputs
Retrieve the list of input parameter names this crew expects so the caller can confirm the supplied inputs object covers every required key.
2
kickoff
kickoffCrew
Launch a crew execution with the supplied inputs and optional metadata and crew webhook, returning the kickoff_id used to poll status.

Source API Descriptions

Arazzo Workflow Specification

crewai-cloud-discover-inputs-and-kickoff-workflow.yml Raw ↑
arazzo: 1.0.1
info:
  title: CrewAI AMP Discover Inputs and Kick Off
  summary: Discover the inputs a crew expects, then launch an execution with them.
  description: >-
    Before launching a crew you usually do not know which input keys it expects.
    This workflow first calls the inputs endpoint to enumerate the parameter
    names the deployed crew requires, then immediately kicks off an execution
    with a supplied inputs object, returning the kickoff identifier that
    subsequent polling can use. Every step spells out its request inline so the
    flow can be read and executed without opening the underlying OpenAPI
    description.
  version: 1.0.0
sourceDescriptions:
- name: crewaiAmpApi
  url: ../openapi/crewai-amp-rest-api-openapi.yml
  type: openapi
workflows:
- workflowId: discover-inputs-and-kickoff
  summary: List the crew's required input names, then kick off an execution.
  description: >-
    Calls GET /inputs to discover the input parameter names the crew expects,
    then calls POST /kickoff with the caller-supplied inputs object to launch an
    execution and capture the kickoff_id.
  inputs:
    type: object
    required:
    - bearerToken
    - inputs
    properties:
      bearerToken:
        type: string
        description: Bearer token from the AMP dashboard Status tab.
      inputs:
        type: object
        description: Key-value pairs of all required inputs for the crew.
      meta:
        type: object
        description: Optional metadata to attach to the kickoff (echoed in events).
      crewWebhookUrl:
        type: string
        description: Optional callback URL invoked when the crew execution completes.
  steps:
  - stepId: listRequiredInputs
    description: >-
      Retrieve the list of input parameter names this crew expects so the caller
      can confirm the supplied inputs object covers every required key.
    operationId: listInputs
    parameters:
    - name: Authorization
      in: header
      value: "Bearer $inputs.bearerToken"
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      requiredInputs: $response.body#/inputs
  - stepId: kickoff
    description: >-
      Launch a crew execution with the supplied inputs and optional metadata and
      crew webhook, returning the kickoff_id used to poll status.
    operationId: kickoffCrew
    parameters:
    - name: Authorization
      in: header
      value: "Bearer $inputs.bearerToken"
    requestBody:
      contentType: application/json
      payload:
        inputs: $inputs.inputs
        meta: $inputs.meta
        crewWebhookUrl: $inputs.crewWebhookUrl
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      kickoffId: $response.body#/kickoff_id
  outputs:
    requiredInputs: $steps.listRequiredInputs.outputs.requiredInputs
    kickoffId: $steps.kickoff.outputs.kickoffId