Skip to main content
POST
/
api
/
v1
/
sov
/
{id}
/
get_or_create_output
Get Or Create SOV Output
curl --request POST \
  --url https://api.sovfixer.com/api/v1/sov/{id}/get_or_create_output \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "output_format": "<string>",
  "job_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "overwrite_existing": false,
  "revision": -1
}
'
{
  "request": {
    "id": "<string>"
  },
  "result": {
    "label": "<string>",
    "output_format": "<string>",
    "scrubbed_filename": "<string>",
    "url": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Token-based authentication with required prefix "Token"

Path Parameters

​
id
string
required

SOV ID or SUD ID.

Body

​
output_format
string
required

The desired output format.

Minimum string length: 1
​
job_id
string<uuid> | null

If provided, associate with this existing job instead of creating a new one.

​
overwrite_existing
boolean
default:false

If true, regenerate the output file even if it already exists.

​
revision
integer
default:-1

The revision number of the SOV to use, -1 is the latest, 0 is the initial SOV (this field is ignored when a SUD ID is provided).

Response

201 - application/json

SOV output response with request status and result if already available.

​
request
object
required

Information about the request status.

​
result
object

Result if the file is already available.