SignalFx Developers Guide

Developer Home

Product Docs

SignalFx

Dashboard Groups API

Dashboard groups let you collect dashboards with common characteristics in one place in the web UI, so you can view them together or in sequence.
The Dashboard Groups API lets you do the following:

  • Create a new dashboard group: POST /dashboardgroup
  • Retrieve the properties of one or more dashboard groups, using a query encoded on the endpoint URL: GET /dashboardgroup
  • Retrieve the properties of a single dashboard group specified by its ID: GET /dashboardgroup/{id}
  • Update the properties of a single dashboard group specified in the {id} path parameter: PUT /dashboardgroup/{id}
  • Make a deep copy (clone) of the dashboard specified in the request body to the group specified in the {id} path parameter: POST `dashboardgroup/{id}/dashboard
  • Add a mirrored dashboard to a group, by updating the list of dashboards associated with the group: PUT /dashboardgroup/{id}
  • Delete the dashboard group specified in the {id} path parameter: DELETE /dashboardgroup/{id}


Dashboard groups have options and functionality that depend on the availability of the mirrored dashboard feature in your organization. Read the Developer Guide topic Working with Dashboards before using the Dashboard Groups API.
If the write permissions feature is available in your organization, you need to ensure you have write permissions for the following dashboard group operations:

  • Adding dashboards to the group
  • Rearranging the order of the group's dashboards
  • Renaming or deleting the group
  • Managing links between the group and teams
    To make changes to a dashboard in the group or charts in a group's dashboard, you need write permission for the dashboard.
    To learn more, see the topic Setting Write Permissions in the product documentation.

Create Single Dashboard Group

Creates a dashboard group

post /dashboardgroup

SignalFx API endpoint.
Replace {REALM} with the name of your realm. For example, if your realm is eu0, use https://api.eu0.signalfx.com/v2.
To find your realm, go to your profile page in the SignalFx web UI.
If you don't include a realm and use https://api.signalfx.com/v2, SignalFx interprets the endpoint as pointing to the us0 realm.

https://api.{REALM}.signalfx.com/v2/dashboardgroup

Creates a dashboard group using the properties specified in the request body. If your organization has the write permissions feature enabled, you can use the authorizedWriters property to specify the users and teams who have permission to edit or delete the group or its dashboards.
To use mirrored dashboards, the following features must be available in your organization:

  • Write permissions
  • Mirrored dashboards
header Parameters
Content-Type
required
string

Format of the request payload. The only allowed value is application/json.

X-SF-Token
required
string

A valid access token, either an org token (referred to as an Access Token in the web UI) or a session token (referred to as a User API Access Token in the web UI).

Request Body schema: application/json
authorizedWriters
object (Organizations and teams with write permission for an object)

Set of organizations and teams that have write permission for the dashboard group, in the form of a JSON object. If your organization has the write permissions feature enabled, you can use this object to specify the user and team IDs that have write access to the dashboard group

dashboards
Array of string (List of dashboards to add to the dashboard group)

List of dashboards, in the form of a JSON array of dashboard IDs. The system adds the specified dashboards to the dashboard group you're creating. If you omit the property, the system creates a new dashboard and assigns it to the new dashboard group.

dashboardConfigs
Array of object (List of dashboard configurations)

List of dashboards associated with the dashboard group, in the form of a a JSON array of JSON objects. In the web UI, SignalFx uses to the current set of configurations for a group to determine which dashboards to display for the group.

description
string (DashboardgroupDescription)

Description of the dashboard group. This value appears in the tooltip for the dashboard group on the Dashboards page in the web UI.

name
required
string (DashboardgroupName) non-empty

Name of the dashboard group. This value identifies the dashboard group in the web UI. It appears on the dashboards page and in the catalog. It also appears at the top left corner of the screen whenever you're viewing a dashboard that the group contains.

teams
Array of string (DashboardgroupTeams)

List of existing teams, in the form of a JSON array of team IDs. The dashboard group appears on the team landing page for any team in the list.

Responses

200

Successful creation of the dashboard group

Response Headers
Access-Control-Allow-Credentials
boolean
Default: true

If true, the response can be exposed to users even if they've authenticated with a front end client using cookies

Access-Control-Allow-Origin
string
Default: "URL of the agent making the request"

Specifies the URIs that can access the results of the request

Access-Control-Expose-Headers
string

A header that can be exposed to front end clients. The headers may contain multiple instances of this header.

Connection
string
Default: "keep-alive"

Specifies how connections should be handled for a series of API calls

Content-Encoding
string
Default: "gzip"

Specifies the content encoding of the response payload, as a standard HTTP content-encoding token

Content-Type
string
Default: "application/json; charset=utf8"

Format of the response payload.

Date
string
Example: "Mon, 01 Jan 2018 10:19:25 UTC"

Timestamp of the response, formatted as ddd, dd mmm yyyy hh:mm:ss. The time zone is UTC.

Transfer-Encoding
string
Default: "chunked"

The form of encoding used to safely transfer the response to the user agent.

Vary
string
Default: "Accept-Encoding, User-Agent"

Indicates that the response payload may be encoded or compressed differently depending on the source of the request. Primarily used to inform caching agents whether content is static or may vary depending on the request settings.

X-Content-Type-Options
string
Default: "nosniff"

Indicates that front-end clients shouldn't attempt to determine the payload format and adjust the content-type to match their expectations.

Response Schema: application/json
authorizedWriters
object (Organizations and teams with write permission for an object)

Set of organizations and teams that have write permission for the dashboard group, in the form of a JSON object. If your organization has the write permissions feature enabled, you can use this object to specify the user and team IDs that have write access to the dashboard group

created
integer <int64> (DashboardgroupCreated)

The dashboard group creation date and time, in the form of a Unix time value, UTC-relative. The system sets this value, and you can't modify it.

creator
string (DashboardgroupCreator)

SignalFx-assigned user ID of the user that created the dashboard group. If the system created this dashboard group, the value is "AAAAAAAAAA". The system sets this value, and you can't modify it.

dashboards
Array of string (List of dashboards to add to the dashboard group)

List of dashboards, in the form of a JSON array of dashboard IDs. The system adds the specified dashboards to the dashboard group you're creating. If you omit the property, the system creates a new dashboard and assigns it to the new dashboard group.

dashboardConfigs
Array of object (List of dashboard configurations)

List of dashboards associated with the dashboard group, in the form of a a JSON array of JSON objects. In the web UI, SignalFx uses to the current set of configurations for a group to determine which dashboards to display for the group.

description
string (DashboardgroupDescription)

Description of the dashboard group. This value appears in the tooltip for the dashboard group on the Dashboards page in the web UI.

id
string (DashboardgroupId)

The SignalFx-assigned ID for this dashboard group.

lastUpdated
integer <int64> (DashboardgroupLastUpdated)

The last time the dashboard group was updated, in Unix time UTC-relative. This value is "read-only".

lastUpdatedBy
string (DashboardgroupLastUpdatedBy)

SignalFx-assigned ID of the last user who updated the dashboard group. If the last update was by the system, the value is "AAAAAAAAAA". This value is "read-only".

name
string (DashboardgroupName) non-empty

Name of the dashboard group. This value identifies the dashboard group in the web UI. It appears on the dashboards page and in the catalog. It also appears at the top left corner of the screen whenever you're viewing a dashboard that the group contains.

teams
Array of string (DashboardgroupTeams)

List of existing teams, in the form of a JSON array of team IDs. The dashboard group appears on the team landing page for any team in the list.

Request samples

application/json
Copy
Expand all Collapse all
{
  • "authorizedWriters":
    {
    },
  • "dashboards":
    [
    ],
  • "dashboardConfigs":
    [
    ],
  • "description": "string",
  • "name": "string",
  • "teams":
    [
    ]
}

Response samples

application/json
Copy
Expand all Collapse all
{
  • "authorizedWriters":
    {
    },
  • "created": 0,
  • "creator": "string",
  • "dashboards":
    [
    ],
  • "dashboardConfigs":
    [
    ],
  • "description": "string",
  • "id": "string",
  • "lastUpdated": 0,
  • "lastUpdatedBy": "string",
  • "name": "string",
  • "teams":
    [
    ]
}

Retrieve Dashboard Groups Using Query

Retrieves dashboard groups based on search criteria

get /dashboardgroup

SignalFx API endpoint.
Replace {REALM} with the name of your realm. For example, if your realm is eu0, use https://api.eu0.signalfx.com/v2.
To find your realm, go to your profile page in the SignalFx web UI.
If you don't include a realm and use https://api.signalfx.com/v2, SignalFx interprets the endpoint as pointing to the us0 realm.

https://api.{REALM}.signalfx.com/v2/dashboardgroup

Retrieves the properties of one or more dashboard groups, based on query parameters you encode on the endpoint URL. If you don't specify parameters, the request returns the first 50 groups to which you have access, based on the access token specified in the request header. Query parameters also control the point in the result set at which the system starts returning groups, and the number of groups to return.

query Parameters
limit
integer <int32>

The maximum number of dashboard groups to return from the query result. If the value isn't valid, the system defaults to 50 groups.

name
string

Search string that SignalFx compares to existing dashboard group names. A match occurs if the string matches any part of the name. For example, the query specification name="per" matches the following (ellipses represent other parts of the name):

  • "...dropped per day..."
  • "...95th percentile"
  • "personal disk usage..."
    If you specify `name=""`, the system ignores the search string.
    The string can only contain ASCII characters.
offset
integer <int32>

0-based index of the point in the query results where SignalFx starts returning dashboard groups. If the offset value is greater than the size of the query results, you don't receive any results.

header Parameters
Content-Type
required
string

Format of the request payload. The only allowed value is application/json.

X-SF-Token
required
string

A valid access token, either an org token (referred to as an Access Token in the web UI) or a session token (referred to as a User API Access Token in the web UI).

Responses

200

Successful retrieval of dashboard groups.
Note: If the system fails to find any dashboard groups that satisfy the query parameters, it returns HTTP status code 200 with an empty response body.

Response Headers
Access-Control-Allow-Credentials
boolean
Default: true

If true, the response can be exposed to users even if they've authenticated with a front end client using cookies

Access-Control-Allow-Origin
string
Default: "URL of the agent making the request"

Specifies the URIs that can access the results of the request

Access-Control-Expose-Headers
string

A header that can be exposed to front end clients. The headers may contain multiple instances of this header.

Connection
string
Default: "keep-alive"

Specifies how connections should be handled for a series of API calls

Content-Encoding
string
Default: "gzip"

Specifies the content encoding of the response payload, as a standard HTTP content-encoding token

Content-Type
string
Default: "application/json; charset=utf8"

Format of the response payload.

Date
string
Example: "Mon, 01 Jan 2018 10:19:25 UTC"

Timestamp of the response, formatted as ddd, dd mmm yyyy hh:mm:ss. The time zone is UTC.

Transfer-Encoding
string
Default: "chunked"

The form of encoding used to safely transfer the response to the user agent.

Vary
string
Default: "Accept-Encoding, User-Agent"

Indicates that the response payload may be encoded or compressed differently depending on the source of the request. Primarily used to inform caching agents whether content is static or may vary depending on the request settings.

X-Content-Type-Options
string
Default: "nosniff"

Indicates that front-end clients shouldn't attempt to determine the payload format and adjust the content-type to match their expectations.

Response Schema: application/json
count
integer <int32>

Number of dashboard groups that matched the provided search criteria.
Note: This value is the total number dashboard groups that matched the criteria. Refer to the description of results to see how many dashboard groups are returned in the response body.

results
Array of object

List of dashboard groups that SignalFx returns, in the form of a JSON array. The number of objects in results depends on the limit and offset query parameters:

  • limit and offset specify a slice of the matching set.
  • If the length of this slice is greater than the number of dashboard groups in the result set, then the results array contains a slice that starts at offset and ends at count.
  • If the length of the specified slice is less than the number of dashboard groups in the matching set, then the results array contains the slice of the matching set specified by limit and offset.

Response samples

application/json
Copy
Expand all Collapse all
{
  • "count": 0,
  • "results":
    [
    ]
}

Retrieve Dashboard Group Using ID

Gets the single dashboard group specified in the {id} path parameter

get /dashboardgroup/{id}

SignalFx API endpoint.
Replace {REALM} with the name of your realm. For example, if your realm is eu0, use https://api.eu0.signalfx.com/v2.
To find your realm, go to your profile page in the SignalFx web UI.
If you don't include a realm and use https://api.signalfx.com/v2, SignalFx interprets the endpoint as pointing to the us0 realm.

https://api.{REALM}.signalfx.com/v2/dashboardgroup/{id}

Retrieves a dashboard group specified by the dashboard group ID in the {id} path parameter.

path Parameters
id
required
string

The SignalFx-assigned ID of an existing dashboard group.

header Parameters
Content-Type
required
string

Format of the request payload. The only allowed value is application/json.

X-SF-Token
required
string

A valid access token, either an org token (referred to as an Access Token in the web UI) or a session token (referred to as a User API Access Token in the web UI).

Responses

200

Successful retrieval of the dashboard group specified in the {id} path parameter

Response Headers
Access-Control-Allow-Credentials
boolean
Default: true

If true, the response can be exposed to users even if they've authenticated with a front end client using cookies

Access-Control-Allow-Origin
string
Default: "URL of the agent making the request"

Specifies the URIs that can access the results of the request

Access-Control-Expose-Headers
string

A header that can be exposed to front end clients. The headers may contain multiple instances of this header.

Connection
string
Default: "keep-alive"

Specifies how connections should be handled for a series of API calls

Content-Encoding
string
Default: "gzip"

Specifies the content encoding of the response payload, as a standard HTTP content-encoding token

Content-Type
string
Default: "application/json; charset=utf8"

Format of the response payload.

Date
string
Example: "Mon, 01 Jan 2018 10:19:25 UTC+0"

Timestamp of the response, formatted as ddd, dd mmm yyyy hh:mm:ss. The time zone is UTC.

Transfer-Encoding
string
Default: "chunked"

The form of encoding used to safely transfer the response to the user agent.

Vary
string
Default: "Accept-Encoding, User-Agent"

Indicates that the response payload may be encoded or compressed differently depending on the source of the request. Primarily used to inform caching agents whether content is static or may vary depending on the request settings.

X-Content-Type-Options
string
Default: "nosniff"

Indicates that front-end clients shouldn't attempt to determine the payload format and adjust the content-type to match their expectations.

Response Schema: application/json
authorizedWriters
object (Organizations and teams with write permission for an object)

Set of organizations and teams that have write permission for the dashboard group, in the form of a JSON object. If your organization has the write permissions feature enabled, you can use this object to specify the user and team IDs that have write access to the dashboard group

created
integer <int64> (DashboardgroupCreated)

The dashboard group creation date and time, in the form of a Unix time value, UTC-relative. The system sets this value, and you can't modify it.

creator
string (DashboardgroupCreator)

SignalFx-assigned user ID of the user that created the dashboard group. If the system created this dashboard group, the value is "AAAAAAAAAA". The system sets this value, and you can't modify it.

dashboards
Array of string (List of dashboards to add to the dashboard group)

List of dashboards, in the form of a JSON array of dashboard IDs. The system adds the specified dashboards to the dashboard group you're creating. If you omit the property, the system creates a new dashboard and assigns it to the new dashboard group.

dashboardConfigs
Array of object (List of dashboard configurations)

List of dashboards associated with the dashboard group, in the form of a a JSON array of JSON objects. In the web UI, SignalFx uses to the current set of configurations for a group to determine which dashboards to display for the group.

description
string (DashboardgroupDescription)

Description of the dashboard group. This value appears in the tooltip for the dashboard group on the Dashboards page in the web UI.

id
string (DashboardgroupId)

The SignalFx-assigned ID for this dashboard group.

lastUpdated
integer <int64> (DashboardgroupLastUpdated)

The last time the dashboard group was updated, in Unix time UTC-relative. This value is "read-only".

lastUpdatedBy
string (DashboardgroupLastUpdatedBy)

SignalFx-assigned ID of the last user who updated the dashboard group. If the last update was by the system, the value is "AAAAAAAAAA". This value is "read-only".

name
string (DashboardgroupName) non-empty

Name of the dashboard group. This value identifies the dashboard group in the web UI. It appears on the dashboards page and in the catalog. It also appears at the top left corner of the screen whenever you're viewing a dashboard that the group contains.

teams
Array of string (DashboardgroupTeams)

List of existing teams, in the form of a JSON array of team IDs. The dashboard group appears on the team landing page for any team in the list.

Response samples

application/json
Copy
Expand all Collapse all
{
  • "authorizedWriters":
    {
    },
  • "created": 0,
  • "creator": "string",
  • "dashboards":
    [
    ],
  • "dashboardConfigs":
    [
    ],
  • "description": "string",
  • "id": "string",
  • "lastUpdated": 0,
  • "lastUpdatedBy": "string",
  • "name": "string",
  • "teams":
    [
    ]
}

Update Single Dashboard Group

Updates a single dashboard group specified in the {id} path parameter

put /dashboardgroup/{id}

SignalFx API endpoint.
Replace {REALM} with the name of your realm. For example, if your realm is eu0, use https://api.eu0.signalfx.com/v2.
To find your realm, go to your profile page in the SignalFx web UI.
If you don't include a realm and use https://api.signalfx.com/v2, SignalFx interprets the endpoint as pointing to the us0 realm.

https://api.{REALM}.signalfx.com/v2/dashboardgroup/{id}

Updates the dashboard group specified by the {id} path parameter, using the properties specified in the request body.
The values you specify in the request body overwrite existing properties. SignalFx either removes or resets properties that you don't specify. In particular, the arrays you specify for to the dashboards, dashboardConfigs, and teams array properties overwrite the existing arrays. To add an element to one or more of these arrays, retrieve the existing dashboard group, copy the existing array, insert the element you want to add into the copy, and use the copy in your PUT request.
Use this method to add a dashboard mirror, by updating the dashboardConfigs array property with a dashboardConfig entry that contains an existing dashboard ID.

path Parameters
id
required
string

The SignalFx-assigned ID of an existing dashboard group.

header Parameters
Content-Type
required
string

Format of the request payload. The only allowed value is application/json.

X-SF-Token
required
string

A valid access token, either an org token (referred to as an Access Token in the web UI) or a session token (referred to as a User API Access Token in the web UI).

Request Body schema: application/json
authorizedWriters
object (Organizations and teams with write permission for an object)

Set of organizations and teams that have write permission for the dashboard group, in the form of a JSON object. If your organization has the write permissions feature enabled, you can use this object to specify the user and team IDs that have write access to the dashboard group

dashboards
Array of string (List of dashboards to add to the dashboard group)

List of dashboards, in the form of a JSON array of dashboard IDs. The system adds the specified dashboards to the dashboard group you're creating. If you omit the property, the system creates a new dashboard and assigns it to the new dashboard group.

dashboardConfigs
Array of object (List of dashboard configurations)

List of dashboards associated with the dashboard group, in the form of a a JSON array of JSON objects. In the web UI, SignalFx uses to the current set of configurations for a group to determine which dashboards to display for the group.

description
string (DashboardgroupDescription)

Description of the dashboard group. This value appears in the tooltip for the dashboard group on the Dashboards page in the web UI.

name
string (DashboardgroupName) non-empty

Name of the dashboard group. This value identifies the dashboard group in the web UI. It appears on the dashboards page and in the catalog. It also appears at the top left corner of the screen whenever you're viewing a dashboard that the group contains.

teams
Array of string (DashboardgroupTeams)

List of existing teams, in the form of a JSON array of team IDs. The dashboard group appears on the team landing page for any team in the list.

Responses

200

Successful update of the dashboard group specified in the ID

Response Headers
Access-Control-Allow-Credentials
boolean
Default: true

If true, the response can be exposed to users even if they've authenticated with a front end client using cookies

Access-Control-Allow-Origin
string
Default: "URL of the agent making the request"

Specifies the URIs that can access the results of the request

Access-Control-Expose-Headers
string

A header that can be exposed to front end clients. The headers may contain multiple instances of this header.

Connection
string
Default: "keep-alive"

Specifies how connections should be handled for a series of API calls

Content-Encoding
string
Default: "gzip"

Specifies the content encoding of the response payload, as a standard HTTP content-encoding token

Content-Type
string
Default: "application/json; charset=utf8"

Format of the response payload.

Date
string
Example: "Mon, 01 Jan 2018 10:19:25 UTC"

Timestamp of the response, formatted as ddd, dd mmm yyyy hh:mm:ss. The time zone is UTC.

Transfer-Encoding
string
Default: "chunked"

The form of encoding used to safely transfer the response to the user agent.

Vary
string
Default: "Accept-Encoding, User-Agent"

Indicates that the response payload may be encoded or compressed differently depending on the source of the request. Primarily used to inform caching agents whether content is static or may vary depending on the request settings.

X-Content-Type-Options
string
Default: "nosniff"

Indicates that front-end clients shouldn't attempt to determine the payload format and adjust the content-type to match their expectations.

Response Schema: application/json
authorizedWriters
object (Organizations and teams with write permission for an object)

Set of organizations and teams that have write permission for the dashboard group, in the form of a JSON object. If your organization has the write permissions feature enabled, you can use this object to specify the user and team IDs that have write access to the dashboard group

created
integer <int64> (DashboardgroupCreated)

The dashboard group creation date and time, in the form of a Unix time value, UTC-relative. The system sets this value, and you can't modify it.

creator
string (DashboardgroupCreator)

SignalFx-assigned user ID of the user that created the dashboard group. If the system created this dashboard group, the value is "AAAAAAAAAA". The system sets this value, and you can't modify it.

dashboards
Array of string (List of dashboards to add to the dashboard group)

List of dashboards, in the form of a JSON array of dashboard IDs. The system adds the specified dashboards to the dashboard group you're creating. If you omit the property, the system creates a new dashboard and assigns it to the new dashboard group.

dashboardConfigs
Array of object (List of dashboard configurations)

List of dashboards associated with the dashboard group, in the form of a a JSON array of JSON objects. In the web UI, SignalFx uses to the current set of configurations for a group to determine which dashboards to display for the group.

description
string (DashboardgroupDescription)

Description of the dashboard group. This value appears in the tooltip for the dashboard group on the Dashboards page in the web UI.

id
string (DashboardgroupId)

The SignalFx-assigned ID for this dashboard group.

lastUpdated
integer <int64> (DashboardgroupLastUpdated)

The last time the dashboard group was updated, in Unix time UTC-relative. This value is "read-only".

lastUpdatedBy
string (DashboardgroupLastUpdatedBy)

SignalFx-assigned ID of the last user who updated the dashboard group. If the last update was by the system, the value is "AAAAAAAAAA". This value is "read-only".

name
string (DashboardgroupName) non-empty

Name of the dashboard group. This value identifies the dashboard group in the web UI. It appears on the dashboards page and in the catalog. It also appears at the top left corner of the screen whenever you're viewing a dashboard that the group contains.

teams
Array of string (DashboardgroupTeams)

List of existing teams, in the form of a JSON array of team IDs. The dashboard group appears on the team landing page for any team in the list.

Request samples

application/json
Copy
Expand all Collapse all
{
  • "authorizedWriters":
    {
    },
  • "dashboards":
    [
    ],
  • "dashboardConfigs":
    [
    ],
  • "description": "string",
  • "name": "string",
  • "teams":
    [
    ]
}

Response samples

application/json
Copy
Expand all Collapse all
{
  • "authorizedWriters":
    {
    },
  • "created": 0,
  • "creator": "string",
  • "dashboards":
    [
    ],
  • "dashboardConfigs":
    [
    ],
  • "description": "string",
  • "id": "string",
  • "lastUpdated": 0,
  • "lastUpdatedBy": "string",
  • "name": "string",
  • "teams":
    [
    ]
}

Delete Single Dashboard Group

Deletes the dashboard group specified in the {id} path parameter

delete /dashboardgroup/{id}

SignalFx API endpoint.
Replace {REALM} with the name of your realm. For example, if your realm is eu0, use https://api.eu0.signalfx.com/v2.
To find your realm, go to your profile page in the SignalFx web UI.
If you don't include a realm and use https://api.signalfx.com/v2, SignalFx interprets the endpoint as pointing to the us0 realm.

https://api.{REALM}.signalfx.com/v2/dashboardgroup/{id}

Deletes the dashboard group specified by the {id} path parameter.
Dashboards associated with the group are affected as follows:

  • If the mirrored dashboard feature isn't available in your organization:
    Deleting the dashboard group deletes all the dashboards associated with the group.
  • If the mirrored dashboard feature is available in your organization:
    If dashboards in the group are mirrored in other groups, then deleting the dashboard group doesn't delete the dashboards.
    If dashboards in the group aren't mirrored in other groups, then deleting the dashboard group deletes the dashboards.
path Parameters
id
required
string

The SignalFx-assigned ID of an existing dashboard group.

header Parameters
Content-Type
required
string

Format of the request payload. The only allowed value is application/json.

X-SF-Token
required
string

A valid access token, either an org token (referred to as an Access Token in the web UI) or a session token (referred to as a User API Access Token in the web UI).

Responses

200

Successful deletion of the specified dashboard group

Response Headers
Access-Control-Allow-Credentials
boolean
Default: true

If true, the response can be exposed to users even if they've authenticated with a front end client using cookies

Access-Control-Allow-Origin
string
Default: "URL of the agent making the request"

Specifies the URIs that can access the results of the request

Access-Control-Expose-Headers
string

A header that can be exposed to front end clients. The headers may contain multiple instances of this header.

Connection
string
Default: "keep-alive"

Specifies how connections should be handled for a series of API calls

Content-Encoding
string
Default: "gzip"

Specifies the content encoding of the response payload, as a standard HTTP content-encoding token

Content-Type
string
Default: "application/json; charset=utf8"

Format of the response payload.

Date
string
Example: "Mon, 01 Jan 2018 10:19:25 UTC"

Timestamp of the response, formatted as ddd, dd mmm yyyy hh:mm:ss. The time zone is UTC.

Transfer-Encoding
string
Default: "chunked"

The form of encoding used to safely transfer the response to the user agent.

Vary
string
Default: "Accept-Encoding, User-Agent"

Indicates that the response payload may be encoded or compressed differently depending on the source of the request. Primarily used to inform caching agents whether content is static or may vary depending on the request settings.

X-Content-Type-Options
string
Default: "nosniff"

Indicates that front-end clients shouldn't attempt to determine the payload format and adjust the content-type to match their expectations.

Clone Dashboard to Group

Makes a deep copy (a **clone**) of an existing dashboard into the dashboard group specified in the {id} path parameter.

post /dashboardgroup/{id}/dashboard

SignalFx API endpoint.
Replace {REALM} with the name of your realm. For example, if your realm is eu0, use https://api.eu0.signalfx.com/v2.
To find your realm, go to your profile page in the SignalFx web UI.
If you don't include a realm and use https://api.signalfx.com/v2, SignalFx interprets the endpoint as pointing to the us0 realm.

https://api.{REALM}.signalfx.com/v2/dashboardgroup/{id}/dashboard


NOTE: This operation doesn't create a mirrored dashboard. Use PUT dashboardgroup/{id} to add a mirrored dashboard to a group.
Creates a new v2 dashboard from an existing dashboard and associates it with the dashboard group specified by the {id} path parameter. The new dashboard is an exact copy of the existing dashboard, but you can change its name, description, and filters by specifying them in your request.
You can clone any dashboard, including built-in dashboards and user dashboards, but you must have authorization to modify the dashboard group into which you're cloning the dashboard.
If you don't have authorization to modify the dashboard you're cloning, the system removes the existing permissions for the dashboard. This lets all users modify the clone.

path Parameters
id
required
string

The SignalFx-assigned ID of an existing dashboard group.

header Parameters
Content-Type
required
string

Format of the request payload. The only allowed value is application/json.

X-SF-Token
required
string

A valid access token, either an org token (referred to as an Access Token in the web UI) or a session token (referred to as a User API Access Token in the web UI).

Request Body schema: application/json
description
string (DashboardDescription)

Dashboard description that overrides the description of a dashboard you're cloning.

filters
object (Filters to apply to all the charts of the cloned dashboard)

Specifies the properties of filters to apply to the cloned dashboard.
This is an optional property that you only need to use if you want to override the filters property of the dashboard you're cloning. Filters give you fine-grained control over the data displayed in the charts in the dashboard. You can specify ad hoc filters or save them as variables for repeated use of the filter criteria.
You can also use filters to apply a custom time window to all of the charts in the dashboard.

name
string (DashboardName)

A human-readable label for the dashboard. The web UI displays this label in the dashboard's group.

sourceDashboard
required
string (Dashboard ID of a cloned dashboard)

The ID of the dashboard to clone into the dashboard group whose ID is specified in the {id} path parameter

Responses

200

Successful copy of a dashboard into another dashboard group

Response Headers
Access-Control-Allow-Credentials
boolean
Default: true

If true, the response can be exposed to users even if they've authenticated with a front end client using cookies

Access-Control-Allow-Origin
string
Default: "URL of the agent making the request"

Specifies the URIs that can access the results of the request

Access-Control-Expose-Headers
string

A header that can be exposed to front end clients. The headers may contain multiple instances of this header.

Connection
string
Default: "keep-alive"

Specifies how connections should be handled for a series of API calls

Content-Encoding
string
Default: "gzip"

Specifies the content encoding of the response payload, as a standard HTTP content-encoding token

Content-Type
string
Default: "application/json; charset=utf8"

Format of the response payload.

Date
string
Example: "Mon, 01 Jan 2018 10:19:25 UTC"

Timestamp of the response, formatted as ddd, dd mmm yyyy hh:mm:ss. The time zone is UTC.

Transfer-Encoding
string
Default: "chunked"

The form of encoding used to safely transfer the response to the user agent.

Vary
string
Default: "Accept-Encoding, User-Agent"

Indicates that the response payload may be encoded or compressed differently depending on the source of the request. Primarily used to inform caching agents whether content is static or may vary depending on the request settings.

X-Content-Type-Options
string
Default: "nosniff"

Indicates that front-end clients shouldn't attempt to determine the payload format and adjust the content-type to match their expectations.

Response Schema: application/json
id
string

SignalFx-assigned ID of the new dashboard.

Request samples

application/json
Copy
Expand all Collapse all
{
  • "description": "string",
  • "filters":
    {
    },
  • "name": "string",
  • "sourceDashboard": "string"
}

Response samples

application/json
Copy
Expand all Collapse all
{
  • "id": "string"
}