Sign in
Objects

Get multiple objects

Retrieve up to 500 objects in one request. Each object the caller can read is returned as the same document GET /v1/objects/{object-id} returns. When delegate names a network map or dashboard the caller can read, objects on it that the caller holds only "delegated read" on are returned as reduced documents marked partial. Failures for individual ids are reported in notFound and denied and do not fail the request.

post/v1/objects/details

Request body

idsinteger[] required

Object IDs. Duplicates are ignored.

delegateinteger

ID of a network map or dashboard. Objects referenced by it are returned as partial documents when the caller holds delegated read on them.

Response

Objects retrieved.

notFoundinteger[]

IDs that do not exist or refer to objects that are unpublished or already deleted.

deniedinteger[]

IDs the caller has no access to.

timestampstring date-time

Server time when the request started, for use as since.

Changes