Search blocks

get

https://api5.optimove.net/content/v1/blocks

Returns a page of the tenant's blocks, without their content. Use GET /blocks/{id} to get a block's content.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

string

Text to search for in the block name, tag name and content. Ignored when shorter than 3 characters.

folderId

uuid

Returns only blocks in this folder.

dateFrom

date-time

Returns only blocks last updated at or after this time (inclusive).
ISO 8601 in UTC, with or without Z, for example 2026-10-01T00:00:00Z. A date without a time means midnight UTC.
Can't be later than dateTo.

dateTo

date-time

Returns only blocks last updated at or before this time (inclusive).
ISO 8601 in UTC, with or without Z, for example 2026-10-31T23:59:59Z.
A date without a time means midnight UTC at the start of that day, so dateTo=2026-10-31 excludes almost all of October 31.
To include the whole day, pass 2026-10-31T23:59:59Z.

skip

int32

≥ 0

Defaults to 0

Number of blocks to skip.

take

int32

1 to 100

Defaults to 20

Maximum number of blocks to return.

sortOrder

string

enum

Defaults to date-newest

Sort order of the results:

date-newest: last updated first
date-oldest: last updated last
name-asc: by name, A to Z
name-desc: by name, Z to A

Allowed:

Responses

401

The X-API-KEY header is missing or the API key is not valid.

403

The API key doesn't have the admin role, or the tenant isn't allowed to change this block.

Language

Credentials

Header

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

*/*

200A page of blocks.

400The request is malformed or fails validation.

429The tenant's rate limit is reached. Retry after the time in x-ratelimit-reset.

500Unexpected server error.