Skip to main content
POST
/
evidences
/
{COMPANY_ID}
/
evidence
Add a evidence with inline category creation
curl --request POST \
  --url https://api.timelockdata.com/api/v1/evidences/{COMPANY_ID}/evidence \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-API-Key: <api-key>' \
  --form 'categoryName=<string>' \
  --form 'categoryId=<string>' \
  --form 'subcategoryName=<string>' \
  --form 'subcategoryId=<string>' \
  --form 'externalId=<string>' \
  --form 'name=<string>' \
  --form 'owner=<string>' \
  --form image='@example-file' \
  --form 'images=<string>' \
  --form 'description=<string>' \
  --form 'summary=<string>' \
  --form 'meta={}' \
  --form images.items='@example-file'
{
  "id": "<string>"
}
Create an evidence record while simultaneously creating or referencing categories and subcategories by name or ID. Useful when you want to create everything in a single request.

Authorizations

X-API-Key
string
header
required

Path Parameters

COMPANY_ID
string
required

Company identifier

Body

multipart/form-data
categoryName
string
required

Name of the category

categoryId
string
required

UUID of the category

subcategoryName
string
required

Name of the subcategory

subcategoryId
string
required

UUID of the subcategory

externalId
string
required

External identifier of the evidence

name
string
required

Name of the evidence

owner
string
required

Initial owner of the evidence

image
file

Icon image for the evidence

images
file[]

Additional images

description
string

Description of the evidence

summary
string

Summary of the evidence

meta
object

Additional metadata for the evidence

Response

201 - application/json

Evidence created

id
string
required

ID of the newly created evidence