list-customer-subscriptions
dci list-customer-subscriptions [flags]
Lists dashboard, report, commitment, alert, and budget subscriptions visible to the caller. Items are ordered by id ascending. Nested subscriptions are ordered by type ascending. maxResults defaults to 50. An omitted value, 0, or a value above 500 is treated as 50. A non-integer maxResults is 400. Pass the response pageToken to request the next page. That field is absent when there are no more pages. A pageToken that matches no id is 400. rowCount is the total number of subscriptions visible to the caller. That value is the same on every page.
One subscription record is one item. Its dashboard, report, and commitment subscriptions are nested entries that share recipients. An alert is one item. A budget is one item. An alert or a budget never shares an item with a scheduled subscription. Draft budgets are omitted. An alert is included only when the tenant has the Governance Alerts entitlement and the caller can view that alert. When the entitlement is missing or cannot be confirmed, the list contains no alerts. An alert with no recipients is still included.
One id namespace is shared by a scheduled subscription, an alert, and a budget. Create accepts only dashboard-subscription, report-subscription, and commitment-manager. Those scheduled types are the resource: create, recipient replace, subscription-set replace, and delete. GET returns alerts and budgets so a caller can see who receives them. Create, delete, and full management of those resources, including recipients, stay on PATCH /analytics/v1/alerts/\{id\} and PATCH /analytics/v1/budgets/\{id\}. PATCH on this API may replace those same recipient lists. DELETE of an alert or a budget returns 409 customers.entry_is_resource.
Manage Settings users can view every subscription. A scheduled subscription is also visible to its creator when the caller has the permission for that type, to an owner, editor, or viewer of its source, and to one of its email recipients. Users Manager alone grants no access. A service-account token is evaluated from its own permissions and does not inherit the permissions of the subscription creator. A caller who can see only some nested subscriptions still receives that record; subscriptions omits the entries they cannot see.
Flags
| Flag | Type | Default | Example | Description |
|---|---|---|---|---|
--max-results | integer (int64) | 50 | The maximum number of results to return in a single page. Use the page tokens to iterate through the entire collection. | |
--page-token | string | Page token, returned by a previous call, to request the next page of results |
Every command also accepts the CLI-wide flags for output shaping — see Output formats and Table output options.
Output
OK - Visible subscriptions returned.
By default dci renders the result as a table. Use --output json to get the full structure described below — see Output formats.
| Field | Type | Description |
|---|---|---|
items | array of object | Subscriptions ordered by id ascending. |
items[].id | string | Server-assigned subscription id. null only on a dry-run create. |
items[].name | string | Display name. For a scheduled subscription, \{source name\} plus (Dashboard Subscription), (Report Subscription), or (Commitment Subscription), from the nested type that sorts first. For an alert or a budget, the source name. |
items[].createdBy | string (email) | Email address of the subscription creator. On create, the caller. |
items[].recipients | object | Delivery targets shared by every nested subscription on this item. |
items[].recipients.emails | array of string (email) | Email destinations in stored order. Reads return each address trimmed and lowercase. Addresses must belong to the organization's approved domains and must be a user or a pending invite. doit.com and doit-intl.com pass the domain check. A blank email, an email with no domain, or a domain the tenant does not allow is refused with 422 and code DOMAIN_NOT_APPROVED. An email that is not a user or a pending invite is refused with 422 and code NOT_INVITED_USER. The same email twice, ignoring case, is refused with 422 and code customers.duplicate_recipient. An address already stored, and still present, is not checked again. |
items[].recipients.slackChannels | array of string | Slack channel ids in stored order. Reads return the public id. Ids are compared exactly after trim. A duplicate id is refused with 422 and code customers.duplicate_recipient. A blank or unconnected id is refused with 422 and code SLACK_CHANNEL_NOT_CONNECTED. This API does not list eligible channels. |
items[].subscriptions | array of object | Nested subscriptions ordered by type ascending. The server sorts them. One entry per visible type. A scheduled subscription has one, two, or three scheduled types. An alert or a budget has exactly one entry. |
items[].subscriptions[].type | string | Kind of nested subscription. |
items[].subscriptions[].source | object | Source resource for this nested subscription. |
items[].subscriptions[].source.id | string | ID of the dashboard, report, commitment, alert, or budget. Writable on create and on a patch of a scheduled subscription. On an alert or a budget it is the resource id. Report ids come from GET /analytics/v1/reports and GET /analytics/v1/reports/\{id\}. Commitment ids come from GET /analytics/v1/commitment-manager and GET /analytics/v1/commitment-manager/\{id\}. |
items[].subscriptions[].source.name | string | Display name of the source resource. |
items[].subscriptions[].schedule | object | Delivery schedule. Omitted for an alert or a budget. Never null. |
items[].subscriptions[].schedule.timeZone | string | IANA time zone used to calculate deliveries. |
items[].subscriptions[].schedule.startDate | string (date-time) | When this schedule starts. The start day is the calendar date of this instant in timeZone, not its UTC date. To start on 2026-11-03 in America/Los_Angeles, send 2026-11-03T00:00:00-08:00 (2026-11-03T08:00:00Z). A read returns the stored instant as UTC RFC3339 (Z). |
items[].subscriptions[].schedule.time | string (date-time) | Stored instant of the delivery clock, returned as UTC RFC3339 (Z). An offset in the request is not preserved. 2026-10-23T10:00:00+02:00 is returned as 2026-10-23T08:00:00Z. The calendar date is the date of that instant. It is stored and returned, and it is not the subscription start date. Deliveries use only the hour and minute of that instant, interpreted in timeZone. Sending time already in Z makes the next read match the sent date and clock. |
items[].subscriptions[].schedule.frequency | string | Console delivery frequency. |
items[].subscriptions[].schedule.nextAt | string (date-time) | Next calculated delivery, returned as UTC RFC3339 (Z). The server sets it. A schedule change recalculates it. |
items[].subscriptions[].schedule.customPeriodAmount | integer | Number of customPeriodUnit between deliveries. Present only when frequency is Custom. At least 1. |
items[].subscriptions[].schedule.customPeriodUnit | string | Unit for customPeriodAmount. Present only when frequency is Custom. |
items[].subscriptions[].attachments | array of string | Files to attach to the report subscription email. Present only for report-subscription. Always an array on read. Empty means no file. Rejected on any other type with 422. |
items[].subscriptions[].pdfSettings | object | PDF rendering options. Present only for report-subscription. Always present on a report read. Rejected on any other type with 422. |
items[].subscriptions[].pdfSettings.showFilters | boolean | Include the report filters summary in the PDF. |
items[].subscriptions[].pdfSettings.includeTable | boolean | Include the data table in the PDF. |
items[].subscriptions[].pdfSettings.includeAnnotations | boolean | Include annotations in the PDF time range. |
items[].subscriptions[].permissions | object | Actions the authenticated caller may perform on this nested subscription. |
items[].subscriptions[].permissions.canEditRecipients | boolean | Whether the caller may replace recipients. |
items[].subscriptions[].permissions.canDelete | boolean | Whether the caller may delete this subscription. Always false for an alert or a budget. |
items[].subscriptions[].permissions.canUnsubscribe | boolean | Whether the caller may remove their own recipient email. |
items[].etag | string | Opaque version token for optimistic concurrency. 64 lowercase hex characters when set. The response ETag header is this value wrapped in double quotes. Send If-Match: "<etag>". null only on a dry-run create. It only covers fields this API can write. |
pageToken | string | Pass as pageToken to fetch the next page. Absent when there are no more pages. |
rowCount | integer (int64) | Total number of subscriptions visible to the caller. The same value is returned on every page. |
Example response (--output json)
{
"items": [
{
"id": "alert_01HX9P2KQVJ8Z3M4T5N6V7W8Y9",
"name": "Production spend alert",
"recipients": {
"emails": [
],
"slackChannels": []
},
"subscriptions": [
{
"type": "alert",
"source": {
"id": "alert_01HX9P2KQVJ8Z3M4T5N6V7W8Y9",
"name": "Production spend alert"
},
"permissions": {
"canEditRecipients": true,
"canDelete": false,
"canUnsubscribe": false
}
}
],
"etag": "9b2e4d6f8a0c1e3b5d7f9a1c3e5b7d9f1a3c5e7a9b1d3f5a7c9e1b3d5f7a9c1e"
},
{
"id": "budget_01HX9P2KQVJ8Z3M4T5N6V7W8Y9",
"name": "Platform budget",
"recipients": {
"emails": [
],
"slackChannels": []
},
"subscriptions": [
{
"type": "budget",
"source": {
"id": "budget_01HX9P2KQVJ8Z3M4T5N6V7W8Y9",
"name": "Platform budget"
},
"permissions": {
"canEditRecipients": true,
"canDelete": false,
"canUnsubscribe": false
}
}
],
"etag": "1a3c5e7a9b1d3f5a7c9e1b3d5f7a9c1e3f7a1c9e2b4d6f8a0c1e3a5b7d9f1b3d"
},
{
"id": "notif_01HX9P2KQVJ8Z3M4T5N6V7W8Y9",
"name": "Executive costs (Dashboard Subscription)",
"recipients": {
"emails": [
],
"slackChannels": [
"C0123ABCD"
]
},
"subscriptions": [
{
"type": "dashboard-subscription",
"source": {
"id": "dashboard_123",
"name": "Executive costs"
},
"schedule": {
"timeZone": "Europe/Warsaw",
"startDate": "2026-10-23T00:00:00Z",
"time": "2026-10-23T08:00:00Z",
"frequency": "Weekly",
"nextAt": "2026-10-30T08:00:00Z"
},
"permissions": {
"canEditRecipients": true,
"canDelete": true,
"canUnsubscribe": false
}
},
{
"type": "report-subscription",
"source": {
"id": "report_456",
"name": "Monthly costs"
},
"schedule": {
"timeZone": "Europe/Warsaw",
"startDate": "2026-11-01T00:00:00Z",
"time": "2026-11-01T08:00:00Z",
"frequency": "Monthly",
"nextAt": "2026-12-01T08:00:00Z"
},
"permissions": {
"canEditRecipients": true,
"canDelete": true,
"canUnsubscribe": false
}
}
],
"etag": "3f7a1c9e2b4d6f8a0c1e3a5b7d9f1b3d5f7a9c1e3b5d7f9a1c3e5b7d9f1a3c5e"
}
],
"rowCount": 3
}
Raw JSON schema
{
"type": "object",
"additionalProperties": false,
"description": "One page of visible subscriptions.",
"required": [
"items",
"rowCount"
],
"properties": {
"items": {
"type": "array",
"description": "Subscriptions ordered by `id` ascending.",
"items": {
"type": "object",
"additionalProperties": false,
"description": "One subscription. A scheduled subscription, an alert, and a budget use this same schema. `etag` is the opaque version token. Quote it when sending `If-Match` (`If-Match: \"<etag>\"`) on update and delete. The `ETag` response header carries that quoted form. `id` and `etag` are null only on a dry-run create.",
"required": [
"id",
"name",
"createdBy",
"recipients",
"subscriptions",
"etag"
],
"properties": {
"id": {
"type": "string",
"readOnly": true,
"x-terraform-computed": true,
"nullable": true,
"description": "Server-assigned subscription id. `null` only on a dry-run create.",
"example": "notif_01HX9P2KQVJ8Z3M4T5N6V7W8Y9"
},
"name": {
"type": "string",
"readOnly": true,
"x-terraform-computed": true,
"description": "Display name. For a scheduled subscription, `{source name}` plus `(Dashboard Subscription)`, `(Report Subscription)`, or `(Commitment Subscription)`, from the nested type that sorts first. For an alert or a budget, the source name.",
"example": "Executive costs (Dashboard Subscription)"
},
"createdBy": {
"type": "string",
"format": "email",
"readOnly": true,
"x-terraform-computed": true,
"x-doit-pii": true,
"description": "Email address of the subscription creator. On create, the caller.",
},
"recipients": {
"description": "Delivery targets shared by every nested subscription on this item.",
"allOf": [
{
"type": "object",
"additionalProperties": false,
"description": "Delivery targets. This object reads and writes email addresses and Slack channel ids only. Microsoft Teams and the in-app bell are not returned and cannot be set. A Teams destination stored in the Console still counts as a destination, so clearing email and Slack on that subscription does not return `409` `customers.last_destination`. Both arrays are always present on read. An unused list is an empty array, never omitted and never `null`. Emails are trimmed and stored lowercase. Channel ids are trimmed. A replaced list is stored in the order sent. Reads do not sort. A disconnected Slack channel stays in the list at its stored id. Create requires at least one email or Slack channel. A stored alert or budget may have both lists empty.",
"required": [
"emails",
"slackChannels"
],
"properties": {
"emails": {
"type": "array",
"minItems": 0,
"description": "Email destinations in stored order. Reads return each address trimmed and lowercase. Addresses must belong to the organization's approved domains and must be a user or a pending invite. `doit.com` and `doit-intl.com` pass the domain check. A blank email, an email with no domain, or a domain the tenant does not allow is refused with `422` and code `DOMAIN_NOT_APPROVED`. An email that is not a user or a pending invite is refused with `422` and code `NOT_INVITED_USER`. The same email twice, ignoring case, is refused with `422` and code `customers.duplicate_recipient`. An address already stored, and still present, is not checked again.",
"items": {
"type": "string",
"format": "email",
"minLength": 1,
"x-doit-pii": true
},
"example": [
]
},
"slackChannels": {
"type": "array",
"minItems": 0,
"description": "Slack channel ids in stored order. Reads return the public id. Ids are compared exactly after trim. A duplicate id is refused with `422` and code `customers.duplicate_recipient`. A blank or unconnected id is refused with `422` and code `SLACK_CHANNEL_NOT_CONNECTED`. This API does not list eligible channels.",
"items": {
"type": "string",
"minLength": 1
},
"example": [
"C0123ABCD"
]
}
},
"example": {
"emails": [
],
"slackChannels": [
"C0123ABCD"
]
}
}
]
},
"subscriptions": {
"type": "array",
"format": "set",
"minItems": 1,
"description": "Nested subscriptions ordered by `type` ascending. The server sorts them. One entry per visible type. A scheduled subscription has one, two, or three scheduled types. An alert or a budget has exactly one entry.",
"items": {
"type": "object",
"additionalProperties": false,
"description": "One nested subscription. `schedule` is present for a dashboard, report, or commitment subscription and omitted for an alert or a budget. `attachments` and `pdfSettings` are present only for a `report-subscription` and omitted for every other type.",
"required": [
"type",
"source",
"permissions"
],
"properties": {
"type": {
"description": "Kind of nested subscription.",
"allOf": [
{
"type": "string",
"description": "Kind of subscription nested on one item. One id namespace is shared by a scheduled subscription, an alert, and a budget. Create accepts only `dashboard-subscription`, `report-subscription`, and `commitment-manager`. GET returns `alert` and `budget`. PATCH may replace their recipient lists, and that is the one write this API makes on them. Those lists are the same ones written by `PATCH /analytics/v1/alerts/{id}` and `PATCH /analytics/v1/budgets/{id}`. DELETE of an alert or a budget returns `409` `customers.entry_is_resource`. `EntryPatch.type` includes `alert` and `budget` so an echo of the stored entry validates.",
"example": "dashboard-subscription",
"enum": [
"alert",
"budget",
"commitment-manager",
"dashboard-subscription",
"report-subscription"
],
"x-enumDescriptions": {
"alert": "Alert entry. One item, and it cannot be deleted through this API.",
"budget": "Budget entry. One item, and it cannot be deleted through this API.",
"commitment-manager": "Commitment subscription. Scheduled delivery of a commitment in Commitment manager.",
"dashboard-subscription": "Dashboard subscription. Scheduled email or Slack delivery of a dashboard.",
"report-subscription": "Report subscription. Scheduled email or Slack delivery of a report."
}
}
],
"example": "dashboard-subscription"
},
"source": {
"description": "Source resource for this nested subscription.",
"allOf": [
{
"type": "object",
"additionalProperties": false,
"description": "Source resource for one nested subscription. `name` is read live from the source and can change without a write to this API.",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "ID of the dashboard, report, commitment, alert, or budget. Writable on create and on a patch of a scheduled subscription. On an alert or a budget it is the resource id. Report ids come from `GET /analytics/v1/reports` and `GET /analytics/v1/reports/{id}`. Commitment ids come from `GET /analytics/v1/commitment-manager` and `GET /analytics/v1/commitment-manager/{id}`.",
"example": "dashboard_123"
},
"name": {
"type": "string",
"readOnly": true,
"x-terraform-computed": true,
"description": "Display name of the source resource.",
"example": "Executive costs"
}
},
"example": {
"id": "dashboard_123",
"name": "Executive costs"
}
}
]
},
"schedule": {
"description": "Delivery schedule. Omitted for an alert or a budget. Never `null`.",
"allOf": [
{
"type": "object",
"additionalProperties": false,
"description": "Delivery schedule for a dashboard, report, or commitment subscription. Omitted on an alert or a budget, never `null`. `customPeriodAmount` and `customPeriodUnit` are omitted unless `frequency` is `Custom`. `nextAt` moves when the next delivery is calculated.",
"required": [
"timeZone",
"startDate",
"time",
"frequency",
"nextAt"
],
"properties": {
"timeZone": {
"type": "string",
"minLength": 1,
"description": "IANA time zone used to calculate deliveries.",
"example": "Europe/Warsaw"
},
"startDate": {
"type": "string",
"format": "date-time",
"description": "When this schedule starts. The start day is the calendar date of this instant in `timeZone`, not its UTC date. To start on 2026-11-03 in `America/Los_Angeles`, send `2026-11-03T00:00:00-08:00` (`2026-11-03T08:00:00Z`). A read returns the stored instant as UTC RFC3339 (`Z`).",
"example": "2026-11-03T08:00:00Z"
},
"time": {
"type": "string",
"format": "date-time",
"description": "Stored instant of the delivery clock, returned as UTC RFC3339 (`Z`). An offset in the request is not preserved. `2026-10-23T10:00:00+02:00` is returned as `2026-10-23T08:00:00Z`. The calendar date is the date of that instant. It is stored and returned, and it is not the subscription start date. Deliveries use only the hour and minute of that instant, interpreted in `timeZone`. Sending `time` already in `Z` makes the next read match the sent date and clock.",
"example": "2026-10-23T08:00:00Z"
},
"frequency": {
"description": "Console delivery frequency.",
"allOf": [
{
"type": "string",
"description": "Console delivery frequency. Wire values match the Console labels.",
"example": "Weekly",
"enum": [
"Daily",
"Weekly",
"Monthly",
"Annually",
"Custom"
],
"x-enumDescriptions": {
"Daily": "Deliver every day at the configured time.",
"Weekly": "Deliver once a week at the configured time.",
"Monthly": "Deliver once a month at the configured time.",
"Annually": "Deliver once a year at the configured time.",
"Custom": "Deliver on the interval in `customPeriodAmount` and `customPeriodUnit`."
}
}
],
"example": "Weekly"
},
"nextAt": {
"type": "string",
"format": "date-time",
"readOnly": true,
"x-terraform-computed": true,
"description": "Next calculated delivery, returned as UTC RFC3339 (`Z`). The server sets it. A schedule change recalculates it.",
"example": "2026-10-30T08:00:00Z"
},
"customPeriodAmount": {
"type": "integer",
"minimum": 1,
"description": "Number of `customPeriodUnit` between deliveries. Present only when `frequency` is `Custom`. At least 1.",
"example": 2
},
"customPeriodUnit": {
"description": "Unit for `customPeriodAmount`. Present only when `frequency` is `Custom`.",
"allOf": [
{
"type": "string",
"description": "Unit for a `Custom` frequency.",
"example": "Month",
"enum": [
"Day",
"Week",
"Month",
"Year"
],
"x-enumDescriptions": {
"Day": "The custom interval is a number of days.",
"Week": "The custom interval is a number of weeks.",
"Month": "The custom interval is a number of months.",
"Year": "The custom interval is a number of years."
}
}
],
"example": "Month"
}
},
"example": {
"timeZone": "Europe/Warsaw",
"startDate": "2026-10-23T00:00:00Z",
"time": "2026-10-23T08:00:00Z",
"frequency": "Weekly",
"nextAt": "2026-10-30T08:00:00Z"
}
}
]
},
"attachments": {
"type": "array",
"uniqueItems": true,
"description": "Files to attach to the report subscription email. Present only for `report-subscription`. Always an array on read. Empty means no file. Rejected on any other type with `422`.",
"items": {
"type": "string",
"description": "File to attach to a report subscription email. Values may appear at most once. Attachments are email-only: Slack-only subscriptions may still store the choice, and delivery skips the files when there is no email recipient. An oversized file is omitted from that email with a note in the body. This API does not upload or return file bytes.",
"example": "pdf",
"enum": [
"pdf",
"csv"
],
"x-enumDescriptions": {
"pdf": "Attach a PDF of the report to the email.",
"csv": "Attach a CSV export of the report to the email."
}
},
"example": [
"pdf",
"csv"
]
},
"pdfSettings": {
"description": "PDF rendering options. Present only for `report-subscription`. Always present on a report read. Rejected on any other type with `422`.",
"allOf": [
{
"type": "object",
"additionalProperties": false,
"description": "PDF rendering options for a report subscription. Present on every `report-subscription` read. A missing stored object reads as all `true`. The flags apply only when `pdf` is in `attachments`. They may still be stored while PDF is off.",
"required": [
"showFilters",
"includeTable",
"includeAnnotations"
],
"properties": {
"showFilters": {
"type": "boolean",
"description": "Include the report filters summary in the PDF.",
"example": true
},
"includeTable": {
"type": "boolean",
"description": "Include the data table in the PDF.",
"example": true
},
"includeAnnotations": {
"type": "boolean",
"description": "Include annotations in the PDF time range.",
"example": true
}
},
"example": {
"showFilters": true,
"includeTable": true,
"includeAnnotations": true
}
}
]
},
"permissions": {
"description": "Actions the authenticated caller may perform on this nested subscription.",
"readOnly": true,
"x-terraform-computed": true,
"allOf": [
{
"type": "object",
"additionalProperties": false,
"description": "Actions the authenticated caller may perform on this nested subscription. Computed per request; a different token can see different values.",
"readOnly": true,
"x-terraform-computed": true,
"required": [
"canEditRecipients",
"canDelete",
"canUnsubscribe"
],
"properties": {
"canEditRecipients": {
"type": "boolean",
"description": "Whether the caller may replace recipients.",
"example": true
},
"canDelete": {
"type": "boolean",
"description": "Whether the caller may delete this subscription. Always `false` for an alert or a budget.",
"example": true
},
"canUnsubscribe": {
"type": "boolean",
"description": "Whether the caller may remove their own recipient email.",
"example": false
}
},
"example": {
"canEditRecipients": true,
"canDelete": true,
"canUnsubscribe": false
}
}
]
}
},
"example": {
"type": "dashboard-subscription",
"source": {
"id": "dashboard_123",
"name": "Executive costs"
},
"schedule": {
"timeZone": "Europe/Warsaw",
"startDate": "2026-10-23T00:00:00Z",
"time": "2026-10-23T08:00:00Z",
"frequency": "Weekly",
"nextAt": "2026-10-30T08:00:00Z"
},
"permissions": {
"canEditRecipients": true,
"canDelete": true,
"canUnsubscribe": false
}
}
}
},
"etag": {
"type": "string",
"readOnly": true,
"x-terraform-computed": true,
"nullable": true,
"description": "Opaque version token for optimistic concurrency. 64 lowercase hex characters when set. The response `ETag` header is this value wrapped in double quotes. Send `If-Match: \"<etag>\"`. `null` only on a dry-run create. It only covers fields this API can write.",
"example": "3f7a1c9e2b4d6f8a0c1e3a5b7d9f1b3d5f7a9c1e3b5d7f9a1c3e5b7d9f1a3c5e"
}
},
"example": {
"id": "notif_01HX9P2KQVJ8Z3M4T5N6V7W8Y9",
"name": "Executive costs (Dashboard Subscription)",
"recipients": {
"emails": [
],
"slackChannels": [
"C0123ABCD"
]
},
"subscriptions": [
{
"type": "dashboard-subscription",
"source": {
"id": "dashboard_123",
"name": "Executive costs"
},
"schedule": {
"timeZone": "Europe/Warsaw",
"startDate": "2026-10-23T00:00:00Z",
"time": "2026-10-23T08:00:00Z",
"frequency": "Weekly",
"nextAt": "2026-10-30T08:00:00Z"
},
"permissions": {
"canEditRecipients": true,
"canDelete": true,
"canUnsubscribe": false
}
}
],
"etag": "3f7a1c9e2b4d6f8a0c1e3a5b7d9f1b3d5f7a9c1e3b5d7f9a1c3e5b7d9f1a3c5e"
}
},
"example": []
},
"pageToken": {
"type": "string",
"description": "Pass as `pageToken` to fetch the next page. Absent when there are no more pages."
},
"rowCount": {
"type": "integer",
"format": "int64",
"description": "Total number of subscriptions visible to the caller. The same value is returned on every page."
}
},
"example": {
"items": [],
"rowCount": 0
}
}
Errors
On failure, dci prints a single error message — with a hint when one is available — and exits with a typed code your scripts can branch on. See Errors and exit codes for the full contract.
HTTP status to exit code mapping
| HTTP status | Exit code | Error code | Meaning |
|---|---|---|---|
| 400 | 30 | VALIDATION_ERROR | The arguments or request body were rejected. Review the command's flags and payload. |
| 401 | 10 | AUTHENTICATION_FAILED | Not signed in, or the API token is invalid. Run dci login or check DCI_API_KEY. |
| 403 | 11 | PERMISSION_DENIED | The DoiT user or the active customer context does not have access. |
| 500 | 40 | API_SERVER_ERROR | The API failed to process the request. Retryable; contact DoiT support if it persists. |
Related
- create-customer-subscription — Create a subscription
- delete-customer-subscription — Delete a subscription
- get-customer-subscription — Retrieve a subscription
- update-customer-subscription — Update a subscription
- API reference: GET /customers/v1/subscriptions
Aliases: listcustomersubscriptions