Requests & Responses

Base URL

All endpoints are under:

https://api.youvico.com/api

Headers

Header	Value
Authorization	Bearer YOUR_API_KEY
Content-Type	application/json, for requests with a body

Request body

The API accepts and returns JSON.

• List endpoints with pagination use the QUERY method and take their inputs in the body. Send {} when you have none.
• To point at another resource, send an object with its id:

{
  "folder": { "id": "DX1234567890ABCD" }
}

Response body

A response with a result wraps it in data:

{
  "data": {
    "id": "bdbff5de-96d7-468f-9db0-85fe28bd6b62",
    "name": "Launch Campaign"
  }
}

• Paginated lists also return a page object. See Pagination.
• Requests that return nothing, such as updates and deletes, respond with 204 No Content.
• Failed requests return an error object. See Errors.

Timestamps

Timestamps are UTC strings in the YYYY-MM-DD HH:mm:ss[.ffffff] format, such as 2026-04-10 05:11:44.482913.

Field types

Field lists in the API reference use this notation:

Notation	Meaning
string	Always a value of that type
string?	A value of that type, or null

Request fields marked required must be sent. Other request fields can be left out.