Clousd Tasks API

The Tasks API from Clousd — 16 operation(s) for tasks.

GitHub OpenAPI

Operations 20

GET /schedules Schedules of this key #
POST /schedules A task that runs by itself - daily, hourly or when you call it #
POST /schedules/{id}/toggle Pause or resume a schedule #
POST /schedules/{id}/delete Delete a schedule #
POST /runs Give one phone or several a task in plain words #
GET /runs Runs of this key, newest first #
GET /runs/{id} One run - status, answer, structured_output, the card it waits on #
DELETE /runs/{id} Delete a finished run with its steps and screenshots #
GET /runs/{id}/events Live events as Server-Sent Events #
GET /runs/{id}/trajectory Every step - tool, target, result, whether the screen was kept #
GET /runs/{id}/steps/{n}.jpg The screen before step n #
POST /runs/{id}/answer Answer the run's card - a question (answer) or a permission (allow / decline) #
POST /runs/{id}/message Tell the running agent something; it reads it before its next step #
POST /runs/{id}/cancel Stop the run #
POST /schedules/{id}/run Start a schedule now - the trigger for trigger=api #
GET /credentials Saved logins - package, name and which fields are set; values are never returned #
POST /credentials Save a login for an app #
POST /credentials/{id}/fields Set one field of a login #
DELETE /credentials/{id}/fields/{type} Remove one field of a login #
DELETE /credentials/{id} Delete a login #

Work with this as data

Every API 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 apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • 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 API
curl "https://apis.io/api/v1/apis/clousd-com:clousd-com-tasks-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.

OpenAPI Specification

clousd-com-tasks-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Clousd Com Tasks API
  version: '1.0'
  description: 'Operations tagged Tasks across 2 of this provider''s published API definitions: clousd-com-openapi-v1.yaml, clousd-com-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.clousd.com/v1
security:
- bearer: []
tags:
- name: Tasks
paths:
  /schedules:
    get:
      summary: Schedules of this key
      tags:
      - Tasks
      operationId: getSchedules
      x-operation-id-source: derived
    post:
      summary: A task that runs by itself - daily, hourly or when you call it
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - phones
              - task
              properties:
                name:
                  type: string
                phones:
                  type: array
                  items:
                    type: string
                  maxItems: 32
                task:
                  type: string
                at:
                  type: string
                  example: 09:00
                  description: HH:MM; with every=hour only the minutes count; not needed for trigger=api
                every:
                  type: string
                  enum:
                  - day
                  - hour
                  default: day
                trigger:
                  type: string
                  enum:
                  - ''
                  - api
                  description: api = never by time, only POST /schedules/{id}/run
                more:
                  type: array
                  maxItems: 12
                  description: More times for the same task
                  items:
                    type: object
                    properties:
                      at:
                        type: string
                      every:
                        type: string
                        enum:
                        - day
                        - hour
                      days:
                        type: array
                        items:
                          type: integer
                days:
                  type: array
                  items:
                    type: integer
                    minimum: 1
                    maximum: 7
                  description: 1 = Monday; empty = every day
                tz:
                  type: string
                  example: Europe/Berlin
                credentials:
                  type: array
                  items:
                    type: object
                    properties:
                      package:
                        type: string
                      name:
                        type: string
                options:
                  type: object
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                type: object
                properties:
                  schedule:
                    type: object
      tags:
      - Tasks
      operationId: postSchedules
      x-operation-id-source: derived
    servers:
    - url: https://api.clousd.com/v1
  /schedules/{id}/toggle:
    post:
      summary: Pause or resume a schedule
      tags:
      - Tasks
      operationId: postSchedulesByIdToggle
      x-operation-id-source: derived
    servers:
    - url: https://api.clousd.com/v1
  /schedules/{id}/delete:
    post:
      summary: Delete a schedule
      tags:
      - Tasks
      operationId: postSchedulesByIdDelete
      x-operation-id-source: derived
    servers:
    - url: https://api.clousd.com/v1
  /runs:
    post:
      summary: Give one phone or several a task in plain words
      description: 'Clousd''s agent looks at the screen, acts and finishes with an answer. `devices` (up to 32) = one run per phone under a parent run, all started at once. `credentials` - saved logins by package and name; their values are typed on the phone and never reach the model or the API response. `options.output_schema` (JSON Schema) - the answer also comes back as `structured_output`. `options.mode`: auto (default for the API) or ask (the run stops with a card before risky steps; reply with POST /runs/{id}/answer). A phone does one run at a time; others wait in its queue. Idempotency-Key: a retry with the same key and body returns the same run.'
      parameters:
      - name: Idempotency-Key
        in: header
        required: false
        schema:
          type: string
          maxLength: 128
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - task
              properties:
                task:
                  type: string
                  description: the goal in plain words
                device:
                  type: string
                devices:
                  type: array
                  items:
                    type: string
                  maxItems: 32
                credentials:
                  type: array
                  items:
                    type: object
                    properties:
                      package:
                        type: string
                      name:
                        type: string
                files:
                  type: array
                  maxItems: 8
                  items:
                    type: integer
                  description: 'Library file ids (GET /media) placed on the phone before the first step: photos and videos in the gallery, documents in Downloads, apks installed; the run lists them with their paths'
                options:
                  type: object
                  properties:
                    mode:
                      type: string
                      enum:
                      - auto
                      - ask
                    max_steps:
                      type: integer
                      description: default 100
                    timeout:
                      type: integer
                      description: seconds
                      default 1000: null
                    output_schema:
                      type: object
                    reasoning:
                      type: boolean
                    vision:
                      type: boolean
                    recording:
                      type: boolean
                source:
                  type: string
                  description: a short label of where the run came from
            example:
              task: Open Settings and tell me the Android version
              device: dev_04f2
      responses:
        '201':
          description: Started
          content:
            application/json:
              schema:
                type: object
                properties:
                  run:
                    $ref: '#/components/schemas/Run'
                  runs:
                    type: array
                    items:
                      $ref: '#/components/schemas/Run'
        '400':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
      tags:
      - Tasks
      operationId: postRuns
      x-operation-id-source: derived
    get:
      summary: Runs of this key, newest first
      parameters:
      - name: status
        in: query
        schema:
          type: string
          enum:
          - queued
          - running
          - paused
          - completed
          - failed
          - cancelled
      - name: device
        in: query
        schema:
          type: string
      - name: since
        in: query
        schema:
          type: string
          format: date-time
      - name: limit
        in: query
        schema:
          type: integer
          maximum: 200
          default: 50
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  runs:
                    type: array
                    items:
                      $ref: '#/components/schemas/Run'
      tags:
      - Tasks
      operationId: getRuns
      x-operation-id-source: derived
    servers:
    - url: https://api.clousd.com/v1
  /runs/{id}:
    get:
      summary: One run - status, answer, structured_output, the card it waits on
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  run:
                    $ref: '#/components/schemas/Run'
      tags:
      - Tasks
      operationId: getRunsById
      x-operation-id-source: derived
    delete:
      summary: Delete a finished run with its steps and screenshots
      tags:
      - Tasks
      operationId: deleteRunsById
      x-operation-id-source: derived
    servers:
    - url: https://api.clousd.com/v1
  /runs/{id}/events:
    get:
      summary: Live events as Server-Sent Events
      description: '`id` is the event number (resume with ?since=N or Last-Event-ID), `event` one of status, step, plan, card, answer, message, log, end; `data` is JSON. The stream ends after `end`. A comment line `: ping` comes every 15 s.'
      parameters:
      - name: since
        in: query
        schema:
          type: integer
      responses:
        '200':
          description: text/event-stream
      tags:
      - Tasks
      operationId: getRunsByIdEvents
      x-operation-id-source: derived
    servers:
    - url: https://api.clousd.com/v1
  /runs/{id}/trajectory:
    get:
      summary: Every step - tool, target, result, whether the screen was kept
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  run:
                    $ref: '#/components/schemas/Run'
                  steps:
                    type: array
                    items:
                      type: object
                      properties:
                        n:
                          type: integer
                        tool:
                          type: string
                        target:
                          type: string
                        result:
                          type: string
                        ok:
                          type: boolean
                        shot:
                          type: boolean
                        ms:
                          type: integer
      tags:
      - Tasks
      operationId: getRunsByIdTrajectory
      x-operation-id-source: derived
    servers:
    - url: https://api.clousd.com/v1
  /runs/{id}/steps/{n}.jpg:
    get:
      summary: The screen before step n
      responses:
        '200':
          description: image/jpeg
      tags:
      - Tasks
      operationId: getRunsByIdSteps{n}Jpg
      x-operation-id-source: derived
    servers:
    - url: https://api.clousd.com/v1
  /runs/{id}/answer:
    post:
      summary: Answer the run's card - a question (answer) or a permission (allow / decline)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - card
              properties:
                card:
                  type: string
                answer:
                  type: string
                allow:
                  type: boolean
                decline:
                  type: boolean
      tags:
      - Tasks
      operationId: postRunsByIdAnswer
      x-operation-id-source: derived
    servers:
    - url: https://api.clousd.com/v1
  /runs/{id}/message:
    post:
      summary: Tell the running agent something; it reads it before its next step
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - text
              properties:
                text:
                  type: string
      tags:
      - Tasks
      operationId: postRunsByIdMessage
      x-operation-id-source: derived
    servers:
    - url: https://api.clousd.com/v1
  /runs/{id}/cancel:
    post:
      summary: Stop the run
      tags:
      - Tasks
      operationId: postRunsByIdCancel
      x-operation-id-source: derived
    servers:
    - url: https://api.clousd.com/v1
  /schedules/{id}/run:
    post:
      summary: Start a schedule now - the trigger for trigger=api
      responses:
        '200':
          description: Started
          content:
            application/json:
              schema:
                type: object
                properties:
                  runs:
                    type: array
                    items:
                      type: string
      tags:
      - Tasks
      operationId: postSchedulesByIdRun
      x-operation-id-source: derived
    servers:
    - url: https://api.clousd.com/v1
  /credentials:
    get:
      summary: Saved logins - package, name and which fields are set; values are never returned
      parameters:
      - name: package
        in: query
        schema:
          type: string
      tags:
      - Tasks
      operationId: getCredentials
      x-operation-id-source: derived
    post:
      summary: Save a login for an app
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - package
              - name
              - fields
              properties:
                package:
                  type: string
                name:
                  type: string
                fields:
                  type: object
                  description: 'type → value; types: username, email, password, phone, totp (secret or otpauth:// link), token, backup'
                  additionalProperties:
                    type: string
      tags:
      - Tasks
      operationId: postCredentials
      x-operation-id-source: derived
    servers:
    - url: https://api.clousd.com/v1
  /credentials/{id}/fields:
    post:
      summary: Set one field of a login
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - type
              - value
              properties:
                type:
                  type: string
                value:
                  type: string
      tags:
      - Tasks
      operationId: postCredentialsByIdFields
      x-operation-id-source: derived
    servers:
    - url: https://api.clousd.com/v1
  /credentials/{id}/fields/{type}:
    delete:
      summary: Remove one field of a login
      tags:
      - Tasks
      operationId: deleteCredentialsByIdFieldsByType
      x-operation-id-source: derived
    servers:
    - url: https://api.clousd.com/v1
  /credentials/{id}:
    delete:
      summary: Delete a login
      tags:
      - Tasks
      operationId: deleteCredentialsById
      x-operation-id-source: derived
    servers:
    - url: https://api.clousd.com/v1
components:
  responses:
    Error:
      description: Error
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
              message:
                type: string
  schemas:
    Run:
      type: object
      properties:
        id:
          type: string
        device:
          type: string
        devices:
          type: array
          items:
            type: string
          description: a parent run on several phones
        children:
          type: array
          items:
            type: string
        parent:
          type: string
        task:
          type: string
        status:
          type: string
          enum:
          - queued
          - created
          - running
          - paused
          - cancelling
          - completed
          - failed
          - cancelled
        succeeded:
          type: boolean
        answer:
          type: string
        error:
          type: string
        structured_output:
          type: object
        card:
          type: object
          properties:
            id:
              type: string
            kind:
              type: string
              enum:
              - question
              - permission
            question:
              type: string
            options:
              type: array
              items:
                type: string
            action:
              type: string
        steps:
          type: integer
        seconds:
          type: integer
        created:
          type: string
          format: date-time
        done:
          type: string
          format: date-time
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
x-refined-from:
- clousd-com-openapi-v1.yaml
- clousd-com-openapi.yml