Skip to main content

Get dashboard folder by ID

GET 
/perses-public/api/v1/projects/:projectId

Returns one folder.

Folders are addressed by id, the UUID returned by create, list and search. The folder's name is not an address: passing it here returns a 404.

Request​

Path Parameters

    projectId stringrequired

    The folder's id.

Responses​

The folder.

Schema
    id string

    The folder's identifier, and the only way to address it.

    name string

    The folder's name. Set from metadata.name when the folder is created, and replaced by spec.display.name on an update or by newProjectName on a rename.

    doc object

    A Perses project document. This is the request body for creating and updating a dashboard folder.

    kind stringrequired

    Possible values: [Project]

    metadata objectrequired
    name stringrequired

    The folder's identity. Required, must be non-empty, and has to be unique within the account.

    spec objectrequired
    display objectrequired

    How the folder is labelled in the app. Required on both create and update.

    name stringrequired

    The name shown in the app. Required, and must be non-empty. On an update it also becomes the folder's name.

    description string
    entityId integer

    Internal handle for the account that owns the folder.

    createdBy integer

    Numeric id of the principal that created the folder. For a folder created through this API this is the id of the API token, not of a user.

    updatedBy integer
    createdAt date-time
    updatedAt date-time
    isDeleted boolean

    Returned as true or false by create, update and rename, and as 1 or 0 by the list, get and search endpoints.

    deletedAt date-time

    Null unless the folder was deleted.

    deletedBy integer

    Null unless the folder was deleted.

Loading...