---
title: "POST /transform/v1/jobs"
method: POST
path: "/transform/v1/jobs"
---

# POST /transform/v1/jobs

`POST /transform/v1/jobs`

Create a new job without an explicit ID.

## Query parameters

- `wait` integer — Only for testing. Maximum number of seconds to block the http request waiting for the job to complete and provide a response, do not use this in production.

## Request body

- object
  - `args` object — Additional arguments that may be used by workflow actions. Binary data may be provided inside a Data URI, including the 'name' parameter.
  - `data` object — Raw JSON data of the GOBL Envelope or Object when the Silo Entry ID is empty.
  - `key` string — Key to associate with the job for idempotency.
  - `silo_entry_id` string — ID for the entry in the silo as an alternative for the raw data object.
  - `tags` string[] — Tags to associate with the job.
  - `workflow_id` string, required — UUID of the workflow to execute for this job.

## Response `202`

Accepted

- TransformJob
  - `args` object — Any additional arguments that might be used by workflow actions.
  - `attachments` TransformFile[] — Any files that have been generated while processing the job in the workflow will be here.
    - `category` string — Category of the file
    - `desc` string — Description of the file
    - `hash` string — SHA256 hash of the file
    - `id` string — UUID for the file inside the entry
    - `key` string — Short identifier for the file.
    - `meta` object — Any additional data that might be relevant.
    - `mime` string — MIME type of the file
    - `name` string — Name of the file
    - `size` integer — Size of the file in bytes
    - `url` string — Public URL where the file can be downloaded.
  - `completed_at` string — When this job was completed, will be nil if still ongoing.
  - `created_at` string — When the job was created.
  - `envelope` object — Raw JSON data of the complete GOBL Envelope.
  - `faults` TransformFault[] — Array of fault objects that represent errors that occurred during the processing of the job.
    - `code` string — Code assigned by the provider that may provide additional information about the fault.
    - `message` string — Message assigned by the provider that may provide additional information about the fault.
    - `provider` string — ID of the provider that generated the fault.
  - `id` string — The UUID v7 or v1 of the job
  - `intents` TransformIntent[] — Array of intent objects following the execution of each of the steps of the associated workflow.
    - `completed` boolean — When true, this intent has completed.
    - `created_at` string — When the intent was created.
    - `events` TransformEvent[] — Array of event objects tracking the execution of the intent.
      - `args` object — Map of additional arguments that will be included in embedded actions.
      - `at` string — When the event was created.
      - `code` string — Code assigned by the provider that may provide additional information about the event.
      - `index` integer — Index of the event in the intent.
      - `message` string — Message assigned by the provider that may provide additional information about the event, especially errors.
      - `silo_entry_id` string — ID of the entry in the silo that was created by this event.
      - `status` string — Status of the event.
    - `id` string — UUIDv4 for the Intent
    - `name` string — Name of the executed workflow step
    - `provider` string — ID of the provider to use
    - `step_id` string — ID of the step to use
    - `updated_at` string — When the intent was last updated.
  - `key` string — Key assigned to the job, used to identify it in the system.
  - `silo_entry_id` string
  - `status` string — Last known status text for this job.
  - `tags` string[] — Any tags that may be useful to be associated with the job.
  - `updated_at` string — When the job was last updated.
  - `workflow_id` string

---

[API](https://skmtc.net/invopop/apis/access-service-api.md) · [All operations](https://skmtc.net/invopop/apis/access-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/invopop/access-service-api/versions/fc954f96ea62/schema)