OpenAI · Arazzo Workflow

OpenAI Upload and Verify File

Version 1.0.0

Upload a file, confirm it appears in the file list, and retrieve its metadata.

1 workflow 1 source API 1 provider
View Spec View on GitHub Artificial IntelligenceLarge Language ModelsT1ArazzoWorkflows

Provider

openai

Workflows

upload-and-verify-file
Upload a file and verify it by listing and retrieving it.
Uploads a file, lists the files for the account, then retrieves the uploaded file metadata and returns its status and byte size.
3 steps inputs: apiKey, file, purpose outputs: fileId, status
1
uploadFile
Upload the file for the supplied purpose.
2
listFiles
List the account files to confirm the upload is present.
3
retrieveFile
Retrieve the uploaded file metadata and return its status.

Source API Descriptions

Arazzo Workflow Specification

Raw ↑
arazzo: 1.0.1
info:
  title: OpenAI Upload and Verify File
  summary: Upload a file, confirm it appears in the file list, and retrieve its metadata.
  description: >-
    Uploads a file for a given purpose, lists the account files to confirm the
    upload is present, and retrieves the file metadata to return its processing
    status. 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: filesApi
  url: ../openapi/openai-files-api-openapi.yml
  type: openapi
workflows:
- workflowId: upload-and-verify-file
  summary: Upload a file and verify it by listing and retrieving it.
  description: >-
    Uploads a file, lists the files for the account, then retrieves the uploaded
    file metadata and returns its status and byte size.
  inputs:
    type: object
    required:
    - apiKey
    - file
    - purpose
    properties:
      apiKey:
        type: string
        description: OpenAI API key used as a Bearer token.
      file:
        type: string
        description: The file contents to upload (binary/multipart field).
      purpose:
        type: string
        description: The intended purpose (assistants, batch, fine-tune, vision, user_data, or evals).
  steps:
  - stepId: uploadFile
    description: Upload the file for the supplied purpose.
    operationId: createFile
    parameters:
    - name: Authorization
      in: header
      value: "Bearer $inputs.apiKey"
    requestBody:
      contentType: multipart/form-data
      payload:
        file: $inputs.file
        purpose: $inputs.purpose
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      fileId: $response.body#/id
  - stepId: listFiles
    description: List the account files to confirm the upload is present.
    operationId: listFiles
    parameters:
    - name: Authorization
      in: header
      value: "Bearer $inputs.apiKey"
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      files: $response.body#/data
  - stepId: retrieveFile
    description: Retrieve the uploaded file metadata and return its status.
    operationId: retrieveFile
    parameters:
    - name: Authorization
      in: header
      value: "Bearer $inputs.apiKey"
    - name: file_id
      in: path
      value: $steps.uploadFile.outputs.fileId
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      status: $response.body#/status
      bytes: $response.body#/bytes
  outputs:
    fileId: $steps.uploadFile.outputs.fileId
    status: $steps.retrieveFile.outputs.status

Work with this as data

Every workflow here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for arazzo workflows

4 MCP tools reach this
  • find_arazzoBrowse and filter every workflow in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This workflow
curl "https://apis.io/api/v1/arazzo/openai-upload-and-verify-file-workflow"
All arazzo workflows
curl "https://apis.io/api/v1/arazzo?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.