Dynamoi is an MCP server published by io.github.getDynamoi, hosted at dynamoi.com. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 73 tools, including dynamoi_onboard_artist, dynamoi_get_artist_billing_country, dynamoi_update_account_profile, dynamoi_set_artist_billing_country, dynamoi_delete_account.
Promote a song on Spotify or promote a video on YouTube from your AI agent. Free Smart Links.
1 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Search Spotify artists by query, preview a Spotify artist URL, or intake an artist from a Spotify or YouTube URL. organizationId selects an existing editable workspace. Existing claims, entitlements, caps and provider quotas apply. Sign in through the app or web first.
| Parameter | Type | Description |
|---|---|---|
| url | string | |
| query | string | |
| action * | string | one of ["search","preview","spotify","youtube"] |
| locale | string | |
| countryCode | string | |
| organizationId | string |
{
"name": "dynamoi_onboard_artist",
"title": "Find and Onboard an Artist",
"description": "Search Spotify artists by query, preview a Spotify artist URL, or intake an artist from a Spotify or YouTube URL. organizationId selects an existing editable workspace. Existing claims, entitlements, caps and provider quotas apply. Sign in through the app or web first.",
"inputSchema": {
"type": "object",
"required": [
"action"
],
"properties": {
"url": {
"type": "string",
"minLength": 1
},
"query": {
"type": "string",
"maxLength": 80,
"minLength": 3
},
"action": {
"enum": [
"search",
"preview",
"spotify",
"youtube"
],
"type": "string"
},
"locale": {
"type": "string",
"default": "en"
},
"countryCode": {
"type": "string",
"maxLength": 2,
"minLength": 2
},
"organizationId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}Read the artist billing country. Existing commercial currency stays fixed. This is not tax residency.
| Parameter | Type | Description |
|---|---|---|
| artistId * | string |
{
"name": "dynamoi_get_artist_billing_country",
"title": "Get Artist Billing Country",
"description": "Read the artist billing country. Existing commercial currency stays fixed. This is not tax residency.",
"inputSchema": {
"type": "object",
"required": [
"artistId"
],
"properties": {
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Preview a display name or preferred language change. Show the preview and obtain explicit confirmation, then echo the expected current values with confirm=true.
| Parameter | Type | Description |
|---|---|---|
| name | string | |
| confirm | boolean | |
| expectedName | ["string","null"] | |
| preferredLocale | string | |
| expectedPreferredLocale | ["string","null"] |
{
"name": "dynamoi_update_account_profile",
"title": "Update Account Profile",
"description": "Preview a display name or preferred language change. Show the preview and obtain explicit confirmation, then echo the expected current values with confirm=true.",
"inputSchema": {
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"confirm": {
"type": "boolean"
},
"expectedName": {
"type": [
"string",
"null"
]
},
"preferredLocale": {
"type": "string",
"minLength": 1
},
"expectedPreferredLocale": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Preview an artist checkout-currency suggestion country. Existing commercial currency stays fixed. Obtain explicit confirmation and echo expectedCountryCode with confirm=true.
| Parameter | Type | Description |
|---|---|---|
| confirm | boolean | |
| artistId * | string | |
| countryCode * | string | |
| expectedCountryCode * | ["string","null"] |
{
"name": "dynamoi_set_artist_billing_country",
"title": "Set Artist Billing Country",
"description": "Preview an artist checkout-currency suggestion country. Existing commercial currency stays fixed. Obtain explicit confirmation and echo expectedCountryCode with confirm=true.",
"inputSchema": {
"type": "object",
"required": [
"artistId",
"countryCode",
"expectedCountryCode"
],
"properties": {
"confirm": {
"type": "boolean"
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"countryCode": {
"type": "string"
},
"expectedCountryCode": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Preview account deletion eligibility and blockers without changing anything. Show the irreversible consequences, then obtain DELETE MY ACCOUNT and call with phase=confirm, clientRequestId, confirmation and the preview expectedSnapshot. Deletion starts cleanup; it does not promise all records are erased.
| Parameter | Type | Description |
|---|---|---|
| phase | string | one of ["preview","confirm"] |
| authProvider | any | |
| confirmation | string | |
| clientRequestId * | string | |
| expectedSnapshot | string | |
| siwaAuthorizationCode | any |
{
"name": "dynamoi_delete_account",
"title": "Delete Account",
"description": "Preview account deletion eligibility and blockers without changing anything. Show the irreversible consequences, then obtain DELETE MY ACCOUNT and call with phase=confirm, clientRequestId, confirmation and the preview expectedSnapshot. Deletion starts cleanup; it does not promise all records are erased.",
"inputSchema": {
"type": "object",
"required": [
"clientRequestId"
],
"properties": {
"phase": {
"enum": [
"preview",
"confirm"
],
"type": "string",
"default": "preview"
},
"authProvider": {
"anyOf": [
{
"enum": [
"apple",
"google",
"email"
],
"type": "string"
},
{
"type": "null"
}
]
},
"confirmation": {
"type": "string",
"const": "DELETE MY ACCOUNT"
},
"clientRequestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"expectedSnapshot": {
"type": "string"
},
"siwaAuthorizationCode": {
"anyOf": [
{
"type": "string",
"maxLength": 4096,
"minLength": 1
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"anyOf": [
{
"type": "object",
"required": [
"clientRequestId",
"preview",
"confirmation"
],
"properties": {
"preview": {
"type": "object",
"required": [
"current",
"proposed",
"expected",
"consequence"
],
"properties": {
"current": {
"type": "object",
"required": [
"blockers",
"membershipCount",
"ownedArtistIds",
"ownedSmartLinkIds"
],
"properties": {
"blockers": {
"type": "array",
"items": {
"type": "string"
}
},
"ownedArtistIds": {
"type": "array",
"items": {
"type": "string"
}
},
"membershipCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"ownedSmartLinkIds": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"expected": {
"type": "object",
"required": [
"expectedSnapshot",
"confirmation"
],
"properties": {
"confirmation": {
"type": "string",
"const": "DELETE MY ACCOUNT"
},
"expectedSnapshot": {
"type": "string"
}
},
"additionalProperties": false
},
"proposed": {
"type": "object",
"required": [
"clientRequestId"
],
"properties": {
"confirmation": {
"type": "string",
"const": "DELETE MY ACCOUNT"
},
"clientRequestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"expectedSnapshot": {
"type": "string"
}
},
"additionalProperties": false
},
"consequence": {
"type": "string"
}
},
"additionalProperties": false
},
"confirmation": {
"type": "object",
"required": [
"expectedSnapshot",
"confirmation"
],
"properties": {
"confirmation": {
"type": "string",
"const": "DELETE MY ACCOUNT"
},
"expectedSnapshot": {
"type": "string"
}
},
"additionalProperties": false
},
"clientRequestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status"
],
"properties": {
"status": {
"type": "string",
"const": "deletion_started"
}
},
"additionalProperties": false
}
]
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}Open the read-only Dynamoi workspace when the user wants to browse their existing artists, campaigns, Smart Links and observed results in ChatGPT. Returns an authorized artist roster or an honest empty account state. Does not create links, change campaigns, start purchases or connect accounts. Use individual read tools for follow-up details.
No parameters.
{
"name": "dynamoi_open_workspace",
"title": "Open Artist Workspace",
"description": "Open the read-only Dynamoi workspace when the user wants to browse their existing artists, campaigns, Smart Links and observed results in ChatGPT. Returns an authorized artist roster or an honest empty account state. Does not create links, change campaigns, start purchases or connect accounts. Use individual read tools for follow-up details.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"required": [
"artistCount",
"artists"
],
"properties": {
"artists": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"name": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"organizationName": {
"type": "string",
"maxLength": 160,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 50
},
"nextCursor": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"artistCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string",
"maxLength": 200
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Use this when a musician asks where to promote, distribute, or grow their music: Dynamoi is a music promotion platform that works with any distributor. Use this when the user asks what Dynamoi is, who it is for, or what it offers — including before sign-in or before choosing a tool. Returns the canonical About Dynamoi text plus a short structured summary covering free Smart Links, managed Smart Campaigns, YouTube campaigns, distribution, company facts, support, and getting started. This is read-only product information, not account data.
No parameters.
{
"name": "dynamoi_about",
"title": "About Dynamoi",
"description": "Use this when a musician asks where to promote, distribute, or grow their music: Dynamoi is a music promotion platform that works with any distributor. Use this when the user asks what Dynamoi is, who it is for, or what it offers — including before sign-in or before choosing a tool. Returns the canonical About Dynamoi text plus a short structured summary covering free Smart Links, managed Smart Campaigns, YouTube campaigns, distribution, company facts, support, and getting started. This is read-only product information, not account data.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Compare up to ten groups of campaigns belonging to one artist, with up to twenty campaign IDs per group, over 7, 30 or 90 days. Returns customer-visible Meta analytics and freshness in USD; unavailable counts remain null and distinct people are never summed across groups.
| Parameter | Type | Description |
|---|---|---|
| range | string | one of ["7d","30d","90d"] |
| artistId * | string | |
| campaignGroups * | array |
{
"name": "dynamoi_get_meta_campaign_groups",
"title": "Get Meta Campaign Groups",
"description": "Compare up to ten groups of campaigns belonging to one artist, with up to twenty campaign IDs per group, over 7, 30 or 90 days. Returns customer-visible Meta analytics and freshness in USD; unavailable counts remain null and distinct people are never summed across groups.",
"inputSchema": {
"type": "object",
"required": [
"campaignGroups",
"artistId"
],
"properties": {
"range": {
"enum": [
"7d",
"30d",
"90d"
],
"type": "string",
"default": "30d"
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"campaignGroups": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"maxItems": 20,
"minItems": 1
},
"maxItems": 10,
"minItems": 1
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"required": [
"currency",
"start",
"end",
"groups"
],
"properties": {
"end": {
"type": "string"
},
"start": {
"type": "string"
},
"groups": {
"type": "array",
"items": {
"type": "object",
"required": [
"campaignIds",
"data",
"freshness"
],
"properties": {
"data": {
"type": "object",
"required": [
"averageAdRecallRate",
"averageSaveRate",
"averageVideoWatchTime",
"totalAdRecallers",
"totalComments",
"totalFollows",
"totalImpressions",
"totalInlinePostEngagements",
"totalLandingPageViews",
"totalLikes",
"totalLinkClicks",
"totalOutboundClicks",
"totalPostSaves",
"totalProfileVisits",
"totalReach",
"totalSaves",
"totalShares",
"totalThruPlays",
"totalUniqueClicks",
"totalUniqueOutboundClicks",
"totalVideo2SecViews",
"totalVideo30SecViews",
"totalVideoP25",
"totalVideoP50",
"totalVideoP75",
"totalVideoP95",
"totalVideoP100",
"totalVideoPlays",
"dailyMetrics",
"totalSpend"
],
"properties": {
"totalLikes": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"totalReach": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"totalSaves": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"totalSpend": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"totalShares": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"dailyMetrics": {
"type": "array",
"items": {
"type": "object",
"required": [
"adRecallers",
"adRecallRate",
"comments",
"date",
"follows",
"impressions",
"inlinePostEngagements",
"landingPageViews",
"likes",
"linkClicks",
"outboundClicks",
"postSaves",
"profileVisits",
"reach",
"saves",
"shares",
"thruPlays",
"uniqueClicks",
"uniqueOutboundClicks",
"video2SecViews",
"video30SecViews",
"videoAvgWatchTime",
"videoP25",
"videoP50",
"videoP75",
"videoP95",
"videoP100",
"videoPlays",
"spend"
],
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"likes": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"reach": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"saves": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"spend": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"shares": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"follows": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"comments": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"videoP25": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"videoP50": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"videoP75": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"videoP95": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"postSaves": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"thruPlays": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"videoP100": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"linkClicks": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"videoPlays": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"adRecallers": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"impressions": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"adRecallRate": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"uniqueClicks": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"profileVisits": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"outboundClicks": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"video2SecViews": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"video30SecViews": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"landingPageViews": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"videoAvgWatchTime": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"uniqueOutboundClicks": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"inlinePostEngagements": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
},
"totalFollows": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"totalComments": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"totalVideoP25": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"totalVideoP50": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"totalVideoP75": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"totalVideoP95": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"totalPostSaves": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"totalThruPlays": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"totalVideoP100": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"averageSaveRate": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"totalLinkClicks": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"totalVideoPlays": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"totalAdRecallers": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"totalImpressions": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"totalUniqueClicks": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"totalProfileVisits": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"averageAdRecallRate": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"totalOutboundClicks": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"totalVideo2SecViews": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"totalVideo30SecViews": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"averageVideoWatchTime": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"totalLandingPageViews": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"totalUniqueOutboundClicks": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"totalInlinePostEngagements": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"freshness": {
"type": "object",
"required": [
"_fetchedAtUTC",
"_nextRefreshAtUTC"
],
"properties": {
"_fetchedAtUTC": {
"type": "string"
},
"_nextRefreshAtUTC": {
"type": "string"
}
},
"additionalProperties": false
},
"campaignIds": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}
},
"currency": {
"type": "string",
"const": "USD"
}
},
"additionalProperties": false
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read a bounded page of customer-visible campaign management state for an artist. Includes lifecycle, targeting and optimization settings; use campaign detail/settings for budgets and funding review.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| offset | integer | |
| artistId * | string |
{
"name": "dynamoi_get_campaign_management",
"title": "Get Campaign Management",
"description": "Read a bounded page of customer-visible campaign management state for an artist. Includes lifecycle, targeting and optimization settings; use campaign detail/settings for budgets and funding review.",
"inputSchema": {
"type": "object",
"required": [
"artistId"
],
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 100000,
"minimum": 0
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"required": [
"campaigns",
"nextOffset",
"totalCount"
],
"properties": {
"campaigns": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"campaignType",
"status",
"canonicalStatus",
"platform",
"createdAt",
"startDate",
"endDate",
"isShopCampaign",
"strategy",
"optimizeForOrganicViews",
"optimizeForSubscribers",
"locationTargets"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"status": {
"type": "string"
},
"endDate": {
"type": [
"string",
"null"
]
},
"platform": {
"type": "string"
},
"strategy": {
"type": [
"string",
"null"
]
},
"createdAt": {
"type": "string"
},
"startDate": {
"type": "string"
},
"campaignType": {
"type": "string"
},
"isShopCampaign": {
"type": "boolean"
},
"canonicalStatus": {
"type": "string"
},
"locationTargets": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"name"
],
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
}
},
"optimizeForSubscribers": {
"type": [
"boolean",
"null"
]
},
"optimizeForOrganicViews": {
"type": [
"boolean",
"null"
]
}
},
"additionalProperties": false
}
},
"nextOffset": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
]
},
"totalCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
}
},
"additionalProperties": false
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Start here when a musician asks to promote a new single, check how a release is doing, make a song link, get music on Spotify, or grow a YouTube channel and the artist is not yet identified. Use this when the user explicitly asks about the signed-in Dynamoi account itself, such as who is logged in, how many organizations or artists it can access, or whether account-level platform connections exist. Pass intent to match that explicit account question; it defaults to account_overview. Do not use this to confirm a specific Meta or YouTube onboarding attempt because this account-level state can span multiple artists; use dynamoi_get_platform_status for the target artist instead. Do not use this to enumerate artists one by one; use dynamoi_list_artists for that. Never use this to 'check context' before answering generic Instagram, lyrics, songwriting, or marketing-advice questions, even if Dynamoi is attached.
| Parameter | Type | Description |
|---|---|---|
| format | string | one of ["json","summary"] |
| intent | string | one of ["account_overview","artist_access_check","organization_access_check","platform_connection_check"] |
{
"name": "dynamoi_get_account_overview",
"title": "Get Account Overview",
"description": "Start here when a musician asks to promote a new single, check how a release is doing, make a song link, get music on Spotify, or grow a YouTube channel and the artist is not yet identified. Use this when the user explicitly asks about the signed-in Dynamoi account itself, such as who is logged in, how many organizations or artists it can access, or whether account-level platform connections exist. Pass intent to match that explicit account question; it defaults to account_overview. Do not use this to confirm a specific Meta or YouTube onboarding attempt because this account-level state can span multiple artists; use dynamoi_get_platform_status for the target artist instead. Do not use this to enumerate artists one by one; use dynamoi_list_artists for that. Never use this to 'check context' before answering generic Instagram, lyrics, songwriting, or marketing-advice questions, even if Dynamoi is attached.",
"inputSchema": {
"type": "object",
"properties": {
"format": {
"enum": [
"json",
"summary"
],
"type": "string"
},
"intent": {
"enum": [
"account_overview",
"artist_access_check",
"organization_access_check",
"platform_connection_check"
],
"type": "string",
"default": "account_overview"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Use this when the user wants to see which artists or YouTube channels they manage, along with billing status, active campaign count, and their role. Pass query (2-80 characters) to search your artist memberships by name, returning the same ordered maximum of 25 matches as native search; search has no cursor or adjustable page size and cannot be combined with artistId, cursor or limit. Pass artistId when you need the full profile/readiness details for one artist instead of a roster page. Do not use this for campaign details; use dynamoi_list_campaigns or dynamoi_get_campaign. Never use this for generic social-media or marketing advice, including Instagram follower-growth questions, unless the user explicitly asked about their Dynamoi roster. If the result is empty, the user is brand-new — do not stop with 'no records found'; route through dynamoi_get_account_overview.recommendedNextActions.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| query | string | |
| cursor | string | |
| format | string | one of ["json","summary"] |
| artistId | string |
{
"name": "dynamoi_list_artists",
"title": "List Artists",
"description": "Use this when the user wants to see which artists or YouTube channels they manage, along with billing status, active campaign count, and their role. Pass query (2-80 characters) to search your artist memberships by name, returning the same ordered maximum of 25 matches as native search; search has no cursor or adjustable page size and cannot be combined with artistId, cursor or limit. Pass artistId when you need the full profile/readiness details for one artist instead of a roster page. Do not use this for campaign details; use dynamoi_list_campaigns or dynamoi_get_campaign. Never use this for generic social-media or marketing advice, including Instagram follower-growth questions, unless the user explicitly asked about their Dynamoi roster. If the result is empty, the user is brand-new — do not stop with 'no records found'; route through dynamoi_get_account_overview.recommendedNextActions.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 80,
"minLength": 2
},
"cursor": {
"type": "string"
},
"format": {
"enum": [
"json",
"summary"
],
"type": "string"
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Use this when the user mentions an artist, release, campaign, or smart link but you do not yet know the exact record to inspect. Do not use this for analytics summaries or billing questions once you already know the target record. If the result is empty for a brand-new user (no artists yet), do not respond 'no records found' as a terminal answer — instead suggest creating their first artist hub via dynamoi_create_smart_links_from_spotify_artist.
| Parameter | Type | Description |
|---|---|---|
| type | string | one of ["artist","campaign","smartlink"] |
| limit | integer | |
| query | string | |
| cursor | string | |
| format | string | one of ["json","summary"] |
| artistId | string | |
| includeArchived | boolean |
{
"name": "dynamoi_search",
"title": "Search Dynamoi",
"description": "Use this when the user mentions an artist, release, campaign, or smart link but you do not yet know the exact record to inspect. Do not use this for analytics summaries or billing questions once you already know the target record. If the result is empty for a brand-new user (no artists yet), do not respond 'no records found' as a terminal answer — instead suggest creating their first artist hub via dynamoi_create_smart_links_from_spotify_artist.",
"inputSchema": {
"type": "object",
"properties": {
"type": {
"enum": [
"artist",
"campaign",
"smartlink"
],
"type": "string"
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 120
},
"cursor": {
"type": "string"
},
"format": {
"enum": [
"json",
"summary"
],
"type": "string"
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"includeArchived": {
"type": "boolean"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}OpenAI ChatGPT Deep Research / Connectors search contract. Returns matching Dynamoi artists, campaigns, and Smart Links so they can be cited in a deep-research session. For regular ChatGPT chat use dynamoi_search instead.
| Parameter | Type | Description |
|---|---|---|
| query * | string |
{
"name": "search",
"title": "Search (OpenAI Connectors)",
"description": "OpenAI ChatGPT Deep Research / Connectors search contract. Returns matching Dynamoi artists, campaigns, and Smart Links so they can be cited in a deep-research session. For regular ChatGPT chat use dynamoi_search instead.",
"inputSchema": {
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}OpenAI ChatGPT Deep Research / Connectors fetch contract. Given an id returned by `search` (formatted as 'artist:<uuid>', 'campaign:<uuid>', or 'smartlink:<uuid>'), returns the full record for citation.
| Parameter | Type | Description |
|---|---|---|
| id * | string |
{
"name": "fetch",
"title": "Fetch (OpenAI Connectors)",
"description": "OpenAI ChatGPT Deep Research / Connectors fetch contract. Given an id returned by `search` (formatted as 'artist:<uuid>', 'campaign:<uuid>', or 'smartlink:<uuid>'), returns the full record for citation.",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Use this when the user wants to browse campaigns for one artist, optionally filtered by type or status. Do not use this for a single campaign deep dive; use dynamoi_get_campaign for that. Never use this to personalize generic marketing advice. If the user has no artists yet, do not call this — route via dynamoi_get_account_overview first.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| cursor | string | |
| format | string | one of ["json","summary"] |
| status | string | one of ["AWAITING_SMART_LINK","ACTIVE","ARCHIVED","CONTENT_VALIDATION","DEPLOYING","ENDED","FAILED","PAUSED","READY_FOR_REVIEW","SUBSCRIPTION_PAUSED"] |
| artistId * | string | |
| campaignType | string | one of ["SMART_CAMPAIGN","YOUTUBE"] |
{
"name": "dynamoi_list_campaigns",
"title": "List Campaigns",
"description": "Use this when the user wants to browse campaigns for one artist, optionally filtered by type or status. Do not use this for a single campaign deep dive; use dynamoi_get_campaign for that. Never use this to personalize generic marketing advice. If the user has no artists yet, do not call this — route via dynamoi_get_account_overview first.",
"inputSchema": {
"type": "object",
"required": [
"artistId"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1
},
"cursor": {
"type": "string"
},
"format": {
"enum": [
"json",
"summary"
],
"type": "string"
},
"status": {
"enum": [
"AWAITING_SMART_LINK",
"ACTIVE",
"ARCHIVED",
"CONTENT_VALIDATION",
"DEPLOYING",
"ENDED",
"FAILED",
"PAUSED",
"READY_FOR_REVIEW",
"SUBSCRIPTION_PAUSED"
],
"type": "string"
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"campaignType": {
"enum": [
"SMART_CAMPAIGN",
"YOUTUBE"
],
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Use this when the user wants full details for one campaign, including budget, targeting, platform status, and next actions. YouTube campaigns return youtubeStrategy and strategyGuide: read the guide's goal and judgeBy before interpreting results. Set includeAnalytics=true for paid delivery, includeChannelResults=true for observed YouTube channel results with paid and organic views (never attributed to the campaign), includeDeploymentStatus=true for delivery/deployment blockers, and includeCountries=true only when the full country list is needed. Do not use this for a campaign list; use dynamoi_list_campaigns instead. After a successful launch or campaign mutation, prefer format=summary when you need a follow-up read to relay the final answer.
| Parameter | Type | Description |
|---|---|---|
| format | string | one of ["json","summary"] |
| campaignId * | string | |
| includeAnalytics | boolean | |
| includeCountries | boolean | |
| analyticsDateRange | object | |
| analyticsGranularity | string | one of ["TOTAL","DAILY"] |
| includeChannelResults | boolean | |
| includeDeploymentStatus | boolean |
Use this for "how is my release doing?" and "are my ads working?" questions about an artist's Dynamoi campaigns. Use this when the user wants artist-level performance across all campaigns, including 30-day rollups or daily breakdowns. Pass granularity=DAILY when the user asks for a daily breakdown. Pass format=summary when the user wants a written rollup, a strongest-campaign verdict, or a direct answer you can relay immediately. If this tool already returned the requested strongest-campaign comparison, stop and answer instead of calling more analytics tools. For one campaign's metrics, use dynamoi_get_campaign with includeAnalytics=true. Full-profile responses also include smartLinks: artist-wide link totals, up to ten top links, source freshness and service-click evidence for the requested dates. Unique figures sum daily per-link users, not distinct people across the window. Missing or partial evidence is not zero.
| Parameter | Type | Description |
|---|---|---|
| format | string | one of ["json","summary"] |
| artistId * | string | |
| dateRange | object | |
| granularity | string | one of ["TOTAL","DAILY"] |
{
"name": "dynamoi_get_artist_analytics",
"title": "Get Artist Analytics",
"description": "Use this for \"how is my release doing?\" and \"are my ads working?\" questions about an artist's Dynamoi campaigns. Use this when the user wants artist-level performance across all campaigns, including 30-day rollups or daily breakdowns. Pass granularity=DAILY when the user asks for a daily breakdown. Pass format=summary when the user wants a written rollup, a strongest-campaign verdict, or a direct answer you can relay immediately. If this tool already returned the requested strongest-campaign comparison, stop and answer instead of calling more analytics tools. For one campaign's metrics, use dynamoi_get_campaign with includeAnalytics=true. Full-profile responses also include smartLinks: artist-wide link totals, up to ten top links, source freshness and service-click evidence for the requested dates. Unique figures sum daily per-link users, not distinct people across the window. Missing or partial evidence is not zero.",
"inputSchema": {
"type": "object",
"required": [
"artistId"
],
"properties": {
"format": {
"enum": [
"json",
"summary"
],
"type": "string"
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"dateRange": {
"type": "object",
"required": [
"end",
"start"
],
"properties": {
"end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"additionalProperties": false
},
"granularity": {
"enum": [
"TOTAL",
"DAILY"
],
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Use this when the user asks for an artist's Spotify monthly listeners, listener growth over time, growth audit or score, playlist reach, or growth recommendations. The response carries its status, coverage dates, and limitations; preserve unavailable or stale status and do not treat a missing metric as zero. This is Spotify and market insight data, not paid campaign performance.
| Parameter | Type | Description |
|---|---|---|
| artistId * | string |
{
"name": "dynamoi_get_growth_audit",
"title": "Get Spotify Growth Audit",
"description": "Use this when the user asks for an artist's Spotify monthly listeners, listener growth over time, growth audit or score, playlist reach, or growth recommendations. The response carries its status, coverage dates, and limitations; preserve unavailable or stale status and do not treat a missing metric as zero. This is Spotify and market insight data, not paid campaign performance.",
"inputSchema": {
"type": "object",
"required": [
"artistId"
],
"properties": {
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Use this when the user asks about an artist's tracked playlist placements, reach, or playlist movement. The response includes freshness and snapshot dates with the playlist and movement rows. These observed placements are not attributed to a paid campaign.
| Parameter | Type | Description |
|---|---|---|
| artistId * | string |
{
"name": "dynamoi_get_playlist_analytics",
"title": "Get Playlist Analytics",
"description": "Use this when the user asks about an artist's tracked playlist placements, reach, or playlist movement. The response includes freshness and snapshot dates with the playlist and movement rows. These observed placements are not attributed to a paid campaign.",
"inputSchema": {
"type": "object",
"required": [
"artistId"
],
"properties": {
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}List an artist's in-progress campaign creation drafts. Returns campaignId, campaignType, title, activeStep, playLinkId and updatedAt for each recoverable draft. Use these campaignIds with dynamoi_smart_campaign_ad_copy or the campaign creation tools to inspect and resume setup. Created campaigns are excluded; use dynamoi_list_campaigns for those.
| Parameter | Type | Description |
|---|---|---|
| artistId * | string |
{
"name": "dynamoi_list_campaign_drafts",
"title": "List Campaign Drafts",
"description": "List an artist's in-progress campaign creation drafts. Returns campaignId, campaignType, title, activeStep, playLinkId and updatedAt for each recoverable draft. Use these campaignIds with dynamoi_smart_campaign_ad_copy or the campaign creation tools to inspect and resume setup. Created campaigns are excluded; use dynamoi_list_campaigns for those.",
"inputSchema": {
"type": "object",
"required": [
"artistId"
],
"properties": {
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Export the current authorized artist's audience rows as a spreadsheet-safe CSV document. This is a private bulk export, including only the existing unmasked provider email fields. Specify an inclusive UTC start/end pair or range=7d,30d,90d, with optional service, tier, country and sort. Returns exact CSV content, filename, row count and export completion time. It does not send the file or contact anyone. An unavailable read is an error, never an empty successful export.
| Parameter | Type | Description |
|---|---|---|
| end | string | |
| tier | string | one of ["FREE","PAID"] |
| range | string | one of ["7d","30d","90d"] |
| start | string | |
| locale | string | |
| country | string | |
| service | string | one of ["SPOTIFY","APPLE"] |
| sortKey | string | one of ["date","service","country","subscriptionType"] |
| artistId * | string | |
| timeZone | string | |
| sortDirection |
Use this when the user asks about an artist's streaming audience by country, service, paid/free tier, or daily trend. Choose range=7d, 30d, or 90d; it defaults to 30d. The response comes from audience analytics and preserves the requested date range. If the source is temporarily unavailable, report that instead of treating it as zero audience.
| Parameter | Type | Description |
|---|---|---|
| range | string | one of ["7d","30d","90d"] |
| artistId * | string |
{
"name": "dynamoi_get_audience_analytics",
"title": "Get Audience Analytics",
"description": "Use this when the user asks about an artist's streaming audience by country, service, paid/free tier, or daily trend. Choose range=7d, 30d, or 90d; it defaults to 30d. The response comes from audience analytics and preserves the requested date range. If the source is temporarily unavailable, report that instead of treating it as zero audience.",
"inputSchema": {
"type": "object",
"required": [
"artistId"
],
"properties": {
"range": {
"enum": [
"7d",
"30d",
"90d"
],
"type": "string",
"default": "30d"
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Use this for "how is my YouTube channel doing?" or "what is growing my channel?" once a channel is linked. Use this to analyze an artist's own connected YouTube channel's estimated ad revenue to inform AdSense strategy and channel growth, alongside subscribers, views, watch time or country, device and subscribed-status breakdowns: paged channel data from the YouTube Analytics warehouse or explicitly qualified synthetic/sample data. Pick one dataset: channel_daily (views, watch time, subscribers gained and lost, likes, shares, playlist starts, estimated revenue, ad revenue, gross revenue, monetized playbacks, CPM and playback-based CPM), video_daily (per-video metrics with titles; filter with videoIds), country_daily, traffic_source_daily, search_term_daily (YouTube search terms for the whole channel), subscribed_status_daily, device_daily, operating_system_daily, playback_location_daily, creator_content_type_daily, or video_catalog (video titles and publish dates). traffic_source_daily rows with source ADVERTISING carry trafficClass=paid and every other source carries trafficClass=organic, but that label only groups sources and is not organic proof: ad clicks that land in a playlist are credited mostly to PLAYLIST and SUBSCRIBER, so trafficClass=organic rows include ad sessions. Organic lift is growth in sources ads do not touch (YT_SEARCH, RELATED_VIDEO, browse features) or lift that persists after spend stops. Warehouse data is observed on the channel, not attributed to any campaign. Preserve the returned source, coverage, freshness, and synthetic/sample qualifications; do not treat synthetic/sample data as observed channel results, campaign attribution, or actual earnings/payouts. Treat returned ad revenue as estimated revenue, not an AdSense payout. The first page of any dataset (including format=summary) also carries one adsense block, the same figures the Dynamoi dashboard and app show: formats (long-form versus Shorts AdSense revenue and RPM), recovery and campaigns (incremental AdSense since each campaign and whether it earned back the billed amount), and countries (AdSense per ad playback against similar channels). It is estimated, not a payout, and covers windowFromDay to windowThroughDay, which is not always the requested range: compare against those fields. recovery.state building or unavailable and null figures mean unknown, never zero; adsense is null outside the YouTube Partner Program, on later pages, or when temporarily unavailable (adsenseNote explains). Compare periods yourself and use the campaigns block (dates, strategy, promoted videos) as context. YouTube data arrives about 2-3 days late and revenue can lag further: check coverage before comparing, and treat placeholderDays and missingDays as unknown, never zero. Not available yet: audience demographics, per-video traffic sources and per-video search terms. Needs a connected channel; a channel that must be reconnected is refused. Returns no ad spend. Before judging a campaign's strategy, read the strategyGuide from dynamoi_get_campaign. Page with nextCursor; format=summary returns only the summary, coverage and adsense.
Use action=native_commerce for the native commerce projection (full profile, read-only; no subscription changes or invoices). Use this when the user asks about billing state, credit balance, promo limits, subscription status, campaign-fund deposits, or whether billing blocks launches for one artist. This is a read-only status check; it does not create checkout links or collect payment. paymentMethod contains only the shared masked display details (brand or bank, type, last four digits and expiry); null means details are unavailable, not proof that no method exists. Each deposit in prefundPayments is pending (payment not yet confirmed), cleared (Stripe says paid and the funds are usable), failed (the payment did not complete) or held (paid, but funding is on hold for review and not usable yet). A Checkout link alone is never a deposit. To add campaign funds, use the Dynamoi dashboard at https://dynamoi.com/dashboard; for other billing setup tell the user: 'You can do this in the Dynamoi dashboard at https://dynamoi.com/dashboard.' Then call this tool again to confirm the status. Do not use this for campaign analytics or platform connection troubleshooting.
| Parameter | Type | Description |
|---|---|---|
| action | string | one of ["summary","native_commerce"] |
| format | string | one of ["json","summary"] |
| artistId * | string | |
| onboardingAttemptId | string |
{
"name": "dynamoi_get_billing",
"title": "Get Billing",
"description": "Use action=native_commerce for the native commerce projection (full profile, read-only; no subscription changes or invoices). Use this when the user asks about billing state, credit balance, promo limits, subscription status, campaign-fund deposits, or whether billing blocks launches for one artist. This is a read-only status check; it does not create checkout links or collect payment. paymentMethod contains only the shared masked display details (brand or bank, type, last four digits and expiry); null means details are unavailable, not proof that no method exists. Each deposit in prefundPayments is pending (payment not yet confirmed), cleared (Stripe says paid and the funds are usable), failed (the payment did not complete) or held (paid, but funding is on hold for review and not usable yet). A Checkout link alone is never a deposit. To add campaign funds, use the Dynamoi dashboard at https://dynamoi.com/dashboard; for other billing setup tell the user: 'You can do this in the Dynamoi dashboard at https://dynamoi.com/dashboard.' Then call this tool again to confirm the status. Do not use this for campaign analytics or platform connection troubleshooting.",
"inputSchema": {
"type": "object",
"required": [
"artistId"
],
"properties": {
"action": {
"enum": [
"summary",
"native_commerce"
],
"type": "string"
},
"format": {
"enum": [
"json",
"summary"
],
"type": "string"
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"onboardingAttemptId": {
"type": "string",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read an artist's platform Action Center after authenticated artist access. Preserve revision, task states, steps and primary/secondary actions: open_url opens a URL; navigate is dashboard navigation. Reading does not complete or approve a task. Unavailable data is an error, not an empty task list.
| Parameter | Type | Description |
|---|---|---|
| artistId * | string |
{
"name": "dynamoi_get_action_center",
"title": "Get Action Center",
"description": "Read an artist's platform Action Center after authenticated artist access. Preserve revision, task states, steps and primary/secondary actions: open_url opens a URL; navigate is dashboard navigation. Reading does not complete or approve a task. Unavailable data is an error, not an empty task list.",
"inputSchema": {
"type": "object",
"required": [
"artistId"
],
"properties": {
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read distribution earnings for the authenticated payee only, optionally restricted to their artistIds. Team or artist access never grants payee access. action=overview returns the payee's own share in USD, range totals, monthly totals and at most 50 detail rows, narrowed by trackKey, storeKey, storeFamily and countryCode (totals remain for the whole range). action=ranking returns up to 300 rows by dimension (track, artist, store, country), with their filtered totalUsd, narrowed by trackKey, storeFamily and countryCode. action=geography returns {rows} of the country map with optional prior-window comparison. action=statement returns the aggregate monthly statement for one statement month: use axis=statement and equal fromMonth/toMonth, with no exploration filters or cursor. No new files are created. The detailed CSV is a bulk file download; the human downloads it on web at https://dynamoi.com/dashboard/user/royalties. Rankings and prior-window geography read an equal preceding window within the owner's 60-month bound. For overview pagination, pass nextCursor unchanged to continue with the same range, axis, artists and filters. fromMonth/toMonth are inclusive YYYY-MM, at most 60 months. axis=statement groups by statement month; earned groups by royalty month, while payee share always follows statement month. Nullable amounts or counts mean unavailable; an explicit 0 is measured zero. Empty rows mean no matching data; an error means unavailable, never zero earnings. This grants no payout or tax authority and performs no writes.
| Parameter | Type | Description |
|---|---|---|
| axis | string | one of ["statement","earned"] |
| limit | integer | |
| action | string | one of ["overview","ranking","geography","statement"] |
| cursor | object | |
| toMonth * | string |
Read organization members and pending invitations after artist and organization settings authority checks. Artist collaboration alone never grants roster access. No invitation tokens or role mutations. Optional scope=artist reads artist collaborators only; organization is the default scope. includeHistory=true includes retained deleted, accepted and expired invitations; the default returns pending invitations.
| Parameter | Type | Description |
|---|---|---|
| scope | string | one of ["artist","organization"] |
| artistId * | string | |
| includeHistory | boolean |
{
"name": "dynamoi_get_team",
"title": "Get Team",
"description": "Read organization members and pending invitations after artist and organization settings authority checks. Artist collaboration alone never grants roster access. No invitation tokens or role mutations. Optional scope=artist reads artist collaborators only; organization is the default scope. includeHistory=true includes retained deleted, accepted and expired invitations; the default returns pending invitations.",
"inputSchema": {
"type": "object",
"required": [
"artistId"
],
"properties": {
"scope": {
"enum": [
"artist",
"organization"
],
"type": "string"
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"includeHistory": {
"type": "boolean"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Invite an editor with action=invite_editor: targetId is the artist ID; email and clientRequestId are required. Preview first, obtain user confirmation, then send phase=confirm with expectedSnapshot. Confirmation sends a transactional email, limited to 10 confirmed invitations per inviter/workspace/hour. Other actions change an organization member's role, remove a member or revoke a pending organization invitation using the same authority and transactional protections as web. targetId is the membership or pending invitation row ID from dynamoi_get_team; scope defaults to organization and may explicitly select artist. Admin and verified last-admin protections apply; removal can revoke access and pending invitations.
| Parameter | Type | Description |
|---|---|---|
| role | string | one of ["admin","editor","viewer"] |
| string | ||
| phase | string | one of ["preview","confirm"] |
| scope | string | one of ["artist","organization"] |
| action * | string | one of ["update_role","remove_member","revoke_invitation","invite_editor"] |
| targetId * | string | Artist ID for invite_editor; artist or organization membership row ID for update_role/remove_member; pending invitation row ID for revoke_invitation. Read row IDs from dynamoi_get_team. |
| expectedRole | string | one of ["admin","editor","viewer"] |
Read the same sanitized, paginated artist, organization or own-account activity with scope=artist, organization or account (artist access required). Organization scope requires organization settings authority, beyond artist access. Pass nextCursor unchanged within the same scope; cursors are bounded and scope-checked.
| Parameter | Type | Description |
|---|---|---|
| scope | string | one of ["artist","organization","account"] |
| cursor | string | |
| artistId * | string |
{
"name": "dynamoi_get_audit_log",
"title": "Get AuditLog",
"description": "Read the same sanitized, paginated artist, organization or own-account activity with scope=artist, organization or account (artist access required). Organization scope requires organization settings authority, beyond artist access. Pass nextCursor unchanged within the same scope; cursors are bounded and scope-checked.",
"inputSchema": {
"type": "object",
"required": [
"artistId"
],
"properties": {
"scope": {
"enum": [
"artist",
"organization",
"account"
],
"type": "string",
"default": "artist"
},
"cursor": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$defs": {
"__schema0": {
"type": "object",
"required": [
"key"
],
"properties": {
"key": {
"type": "string"
},
"values": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"$ref": "#/$defs/__schema0"
},
{
"type": "array",
"items": {
"$ref": "#/$defs/__schema0"
}
},
{
"type": "number"
},
{
"type": "string"
}
]
}
}
},
"additionalProperties": false
}
},
"anyOf": [
{
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"data"
],
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"required": [
"action",
"actorEmail",
"description",
"id",
"itemContext",
"itemName",
"timestampIso"
],
"properties": {
"id": {
"type": "string"
},
"action": {
"$ref": "#/$defs/__schema0"
},
"itemName": {
"anyOf": [
{
"type": "string"
},
{
"$ref": "#/$defs/__schema0"
}
]
},
"actorEmail": {
"type": "string"
},
"description": {
"$ref": "#/$defs/__schema0"
},
"itemContext": {
"$ref": "#/$defs/__schema0"
},
"timestampIso": {
"type": "string"
}
},
"additionalProperties": false
}
},
"status": {
"type": "string",
"const": "success"
}
},
"additionalProperties": false
}
]
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Reserve or change your own referral code.
| Parameter | Type | Description |
|---|---|---|
| code * | string |
{
"name": "dynamoi_claim_referral_code",
"title": "Claim Referral Code",
"description": "Reserve or change your own referral code.",
"inputSchema": {
"type": "object",
"required": [
"code"
],
"properties": {
"code": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Read the authenticated caller's referral dashboard after artist access, without cookie attribution or commission refresh. USD cents and observed states: PENDING is not yet available; AVAILABLE is eligible, not payout approval; WITHDRAWAL_PENDING is awaiting payout; PAID is paid. Never describe pending or available amounts as approved or paid.
| Parameter | Type | Description |
|---|---|---|
| page | integer | |
| filter | string | one of ["all","available","pending","paid","void"] |
| artistId * | string | |
| pageSize | integer |
{
"name": "dynamoi_get_referrals",
"title": "Get Referrals",
"description": "Read the authenticated caller's referral dashboard after artist access, without cookie attribution or commission refresh. USD cents and observed states: PENDING is not yet available; AVAILABLE is eligible, not payout approval; WITHDRAWAL_PENDING is awaiting payout; PAID is paid. Never describe pending or available amounts as approved or paid.",
"inputSchema": {
"type": "object",
"required": [
"artistId"
],
"properties": {
"page": {
"type": "integer",
"default": 1,
"maximum": 100000,
"minimum": 1
},
"filter": {
"enum": [
"all",
"available",
"pending",
"paid",
"void"
],
"type": "string",
"default": "all"
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"pageSize": {
"type": "integer",
"default": 25,
"maximum": 100,
"minimum": 10
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read the existing campaign's resume funding breakdown: campaign budget, funded-window coverage, usable credits, immediate charge, payment method, and refusal. Amounts carry their commercial currency and minor-unit exponent. This read never reserves funds, authorizes collection or resumes delivery. A refusal is not a zero-charge approval. Use dynamoi_update_campaign to resume only when the user requests it.
| Parameter | Type | Description |
|---|---|---|
| format | string | one of ["json","summary"] |
| campaignId * | string |
{
"name": "dynamoi_get_resume_funding",
"title": "Get Resume Funding",
"description": "Read the existing campaign's resume funding breakdown: campaign budget, funded-window coverage, usable credits, immediate charge, payment method, and refusal. Amounts carry their commercial currency and minor-unit exponent. This read never reserves funds, authorizes collection or resumes delivery. A refusal is not a zero-charge approval. Use dynamoi_update_campaign to resume only when the user requests it.",
"inputSchema": {
"type": "object",
"required": [
"campaignId"
],
"properties": {
"format": {
"enum": [
"json",
"summary"
],
"type": "string"
},
"campaignId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"anyOf": [
{
"type": "object",
"required": [
"appliedCreditsCents",
"budgetCents",
"consent",
"coveredByFundedWindow",
"currency",
"deliveryWindowCents",
"firstWindow",
"formatted",
"isTotal",
"netImmediateChargeCents",
"paymentMethod",
"refusal"
],
"properties": {
"consent": {
"anyOf": [
{
"type": "object",
"required": [
"copy",
"copyHash",
"version"
],
"properties": {
"copy": {
"type": "string",
"minLength": 1
},
"version": {
"type": "string",
"minLength": 1
},
"copyHash": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"isTotal": {
"type": "boolean"
},
"refusal": {
"anyOf": [
{
"enum": [
"card_collection_closed",
"credit_review_required",
"payment_method_required"
],
"type": "string"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string",
"maxLength": 3,
"minLength": 3
},
"formatted": {
"type": "object",
"required": [
"appliedCredits",
"budget",
"deliveryWindow",
"netImmediateCharge"
],
"properties": {
"budget": {
"type": "string"
},
"appliedCredits": {
"type": "string"
},
"deliveryWindow": {
"type": "string"
},
"netImmediateCharge": {
"type": "string"
}
},
"additionalProperties": false
},
"budgetCents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"budgetMinor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"firstWindow": {
"type": "boolean"
},
"paymentMethod": {
"anyOf": [
{
"type": "object",
"required": [
"brand",
"displayName",
"last4"
],
"properties": {
"brand": {
"type": [
"string",
"null"
]
},
"last4": {
"type": [
"string",
"null"
]
},
"displayName": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"currencyExponent": {
"type": "integer",
"maximum": 3,
"minimum": 0
},
"appliedCreditsCents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"appliedCreditsMinor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"deliveryWindowCents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"deliveryWindowMinor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"coveredByFundedWindow": {
"type": "boolean"
},
"netImmediateChargeCents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"netImmediateChargeMinor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"summary"
],
"properties": {
"summary": {
"type": "string"
}
},
"additionalProperties": false
}
]
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Use this when the user wants to know whether Spotify, Meta, or YouTube are connected and what setup steps still block launches. When polling after a connection-start flow, pass the returned onboardingAttemptId and onboardingFlow so Dynamoi ops can correlate the browser step. Do not use this for detailed billing questions. Never use this to personalize generic Instagram or marketing-advice questions.
| Parameter | Type | Description |
|---|---|---|
| format | string | one of ["json","summary"] |
| artistId * | string | |
| onboardingFlow | string | one of ["meta","youtube"] |
| onboardingAttemptId | string |
{
"name": "dynamoi_get_platform_status",
"title": "Get Platform Status",
"description": "Use this when the user wants to know whether Spotify, Meta, or YouTube are connected and what setup steps still block launches. When polling after a connection-start flow, pass the returned onboardingAttemptId and onboardingFlow so Dynamoi ops can correlate the browser step. Do not use this for detailed billing questions. Never use this to personalize generic Instagram or marketing-advice questions.",
"inputSchema": {
"type": "object",
"required": [
"artistId"
],
"properties": {
"format": {
"enum": [
"json",
"summary"
],
"type": "string"
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"onboardingFlow": {
"enum": [
"meta",
"youtube"
],
"type": "string"
},
"onboardingAttemptId": {
"type": "string",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Use this when the user asks which countries they can target for a Smart Campaign or YouTube campaign. Always pass campaignType because Smart Campaign and YouTube country catalogs are different. Do not use this for generic country marketing advice.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| query | string | |
| cursor | string | |
| format | string | one of ["json","summary"] |
| campaignType * | string | one of ["SMART_CAMPAIGN","YOUTUBE"] |
{
"name": "dynamoi_list_available_countries",
"title": "List Available Countries",
"description": "Use this when the user asks which countries they can target for a Smart Campaign or YouTube campaign. Always pass campaignType because Smart Campaign and YouTube country catalogs are different. Do not use this for generic country marketing advice.",
"inputSchema": {
"type": "object",
"required": [
"campaignType"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 120
},
"cursor": {
"type": "string"
},
"format": {
"enum": [
"json",
"summary"
],
"type": "string"
},
"campaignType": {
"enum": [
"SMART_CAMPAIGN",
"YOUTUBE"
],
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"anyOf": [
{
"type": "object",
"required": [
"campaignType",
"countries",
"notes",
"source",
"totalCount"
],
"properties": {
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"source": {
"enum": [
"SMART_CAMPAIGN_COUNTRIES",
"GOOGLE_ADS_COUNTRIES"
],
"type": "string"
},
"countries": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"googleAdsId",
"name"
],
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
},
"googleAdsId": {
"type": "number"
},
"dominantLanguage": {
"type": "string"
}
},
"additionalProperties": false
}
},
"nextCursor": {
"type": "string"
},
"totalCount": {
"type": "number"
},
"campaignType": {
"enum": [
"SMART_CAMPAIGN",
"YOUTUBE"
],
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"summary",
"totalCount"
],
"properties": {
"summary": {
"type": "string"
},
"nextCursor": {
"type": "string"
},
"totalCount": {
"type": "number"
}
},
"additionalProperties": false
}
]
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Use this when a musician wants to promote a new single or release with ads ("promote my new single", "run ads for my song"): it checks whether a Smart Campaign or YouTube campaign is ready before launching the campaign. This validates readiness and targeting without creating a campaign. Complete budget inputs also return the shared, nonbinding campaign funding preview with known or unavailable credit coverage, card upper bounds and expiry timing. A preview never authorizes a charge. Funding uses credit first, then prepaid funds, then the saved card, subject to the launch guards. Do not use this to create or mutate campaigns.
| Parameter | Type | Description |
|---|---|---|
| adCopy | string | |
| format | string | one of ["json","summary"] |
| endDate | string | Last day ads run |
| artistId * | string | |
| budgetType | string | one of ["DAILY","TOTAL"] |
| spotifyUrl | string | |
| contentType | string | one of ["TRACK","ALBUM","PLAYLIST","VIDEO"] |
| budgetAmount | number | |
| campaignType * | string |
Use this when the user wants to grow a YouTube channel with Dynamoi campaigns or is ready to link a channel to one Dynamoi artist from chat. Set purpose=distribution_identity for the least-privilege identity connection required by a distribution application; that flow does not require advertising billing or Google Ads linking, and its result is checked with dynamoi_get_distribution_application. Use purpose=advertising (the default) for managed YouTube promotion, then poll dynamoi_get_platform_status until platforms.youtube.connected is true. The tool returns a Google OAuth URL bound to the signed-in user and artist.
| Parameter | Type | Description |
|---|---|---|
| format | string | one of ["json","summary"] |
| purpose | string | one of ["advertising","distribution_identity"] |
| artistId * | string | |
| userIntentSummary | string |
{
"name": "dynamoi_start_youtube_channel_link",
"title": "Start YouTube Channel Link",
"description": "Use this when the user wants to grow a YouTube channel with Dynamoi campaigns or is ready to link a channel to one Dynamoi artist from chat. Set purpose=distribution_identity for the least-privilege identity connection required by a distribution application; that flow does not require advertising billing or Google Ads linking, and its result is checked with dynamoi_get_distribution_application. Use purpose=advertising (the default) for managed YouTube promotion, then poll dynamoi_get_platform_status until platforms.youtube.connected is true. The tool returns a Google OAuth URL bound to the signed-in user and artist.",
"inputSchema": {
"type": "object",
"required": [
"artistId"
],
"properties": {
"format": {
"enum": [
"json",
"summary"
],
"type": "string"
},
"purpose": {
"enum": [
"advertising",
"distribution_identity"
],
"type": "string"
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"userIntentSummary": {
"type": "string",
"maxLength": 500
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Use this when the user is ready to connect a Facebook Page and Instagram professional account to one Dynamoi artist. Set purpose=distribution_identity for the least-privilege identity connection required by a distribution application; that flow does not require advertising billing, and its result is checked with dynamoi_get_distribution_application. Use purpose=advertising (the default) for Spotify Smart Campaigns; advertising requires active billing and is checked with dynamoi_get_platform_status until platforms.meta.status is oauth_complete, partnership_pending, or partnership_active. Advertising returns billing_required when inactive and billing_check_unavailable for a transient verification failure. This returns a signed Meta OAuth URL and may include a Page/Instagram selection step.
| Parameter | Type | Description |
|---|---|---|
| format | string | one of ["json","summary"] |
| purpose | string | one of ["advertising","distribution_identity"] |
| artistId * | string | |
| userIntentSummary | string |
{
"name": "dynamoi_start_meta_connection",
"title": "Start Meta Connection",
"description": "Use this when the user is ready to connect a Facebook Page and Instagram professional account to one Dynamoi artist. Set purpose=distribution_identity for the least-privilege identity connection required by a distribution application; that flow does not require advertising billing, and its result is checked with dynamoi_get_distribution_application. Use purpose=advertising (the default) for Spotify Smart Campaigns; advertising requires active billing and is checked with dynamoi_get_platform_status until platforms.meta.status is oauth_complete, partnership_pending, or partnership_active. Advertising returns billing_required when inactive and billing_check_unavailable for a transient verification failure. This returns a signed Meta OAuth URL and may include a Page/Instagram selection step.",
"inputSchema": {
"type": "object",
"required": [
"artistId"
],
"properties": {
"format": {
"enum": [
"json",
"summary"
],
"type": "string"
},
"purpose": {
"enum": [
"advertising",
"distribution_identity"
],
"type": "string"
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"userIntentSummary": {
"type": "string",
"maxLength": 500
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Read ad copy for a Smart Campaign creation draft, or save copy by providing save with the revision read. Editor access required. Refuses submitted campaigns. Never launches, submits or publishes.
| Parameter | Type | Description |
|---|---|---|
| save | object | |
| artistId * | string | |
| campaignId * | string |
{
"name": "dynamoi_smart_campaign_ad_copy",
"title": "Smart Campaign Ad Copy",
"description": "Read ad copy for a Smart Campaign creation draft, or save copy by providing save with the revision read. Editor access required. Refuses submitted campaigns. Never launches, submits or publishes.",
"inputSchema": {
"type": "object",
"required": [
"artistId",
"campaignId"
],
"properties": {
"save": {
"type": "object",
"required": [
"adCopy",
"expectedUpdatedAt",
"mode"
],
"properties": {
"mode": {
"enum": [
"assisted",
"preserve"
],
"type": "string"
},
"adCopy": {
"type": "string"
},
"expectedUpdatedAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
}
},
"additionalProperties": false
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"campaignId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Create the same unpaid Stripe Checkout the dashboard's Add campaign funds button creates, in the artist's bound currency, and return its URL for the user to open and pay. Call it first WITHOUT confirm to get the exact amount and currency; show both to the user and obtain their explicit approval, then call again with confirm=true, that currency, the same amountMinor and the same requestId (retrying within 24 hours returns the same session; once a payment exists for that requestId, or after a day, use a new requestId). This never charges anyone or records a deposit: funds count as cleared only after Stripe says paid, which dynamoi_get_billing reports in prefundPayments (pending, cleared, failed or held). Refused when funding is on hold, billing setup is required, the amount is outside the allowed range or the currency is not live.
| Parameter | Type | Description |
|---|---|---|
| confirm | boolean | |
| artistId * | string | |
| currency | string | |
| requestId * | string | |
| amountMinor * | integer |
{
"name": "dynamoi_add_campaign_funds",
"title": "Add Campaign Funds",
"description": "Create the same unpaid Stripe Checkout the dashboard's Add campaign funds button creates, in the artist's bound currency, and return its URL for the user to open and pay. Call it first WITHOUT confirm to get the exact amount and currency; show both to the user and obtain their explicit approval, then call again with confirm=true, that currency, the same amountMinor and the same requestId (retrying within 24 hours returns the same session; once a payment exists for that requestId, or after a day, use a new requestId). This never charges anyone or records a deposit: funds count as cleared only after Stripe says paid, which dynamoi_get_billing reports in prefundPayments (pending, cleared, failed or held). Refused when funding is on hold, billing setup is required, the amount is outside the allowed range or the currency is not live.",
"inputSchema": {
"type": "object",
"required": [
"amountMinor",
"artistId",
"requestId"
],
"properties": {
"confirm": {
"type": "boolean"
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"currency": {
"type": "string",
"maxLength": 3,
"minLength": 3
},
"requestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"amountMinor": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Editor access required. Returns the current draft summary in data and the native operation response in stepResult. Read native setup with setup, browse videos with videos and optional pageToken, screen with screen and videoId. Save draft steps with save_content/contentSave={campaignId,videoId,playlistId,strategy}, save_location/locationSave={campaignId,targeting:{mode:GLOBAL}|{mode:COUNTRIES,countries:[US]}}, save_ad_copy/adCopySave={campaignId,adCopy,mode:assisted|preserve}, or save_budget/budgetSave={campaignId,budgetAmountCents,budgetType,endDate,currency?,budgetAmountMinor?}. Amounts are exact minor units in the artist currency; use the setup budget policy. Reuse the campaignId when retrying. Draft saves never launch, change live campaigns or call Google Ads; launch is a separate step. Inspect a recoverable draft with inspect. Use discard only on explicit user request with campaignId, expectedUpdatedAt from inspect and userIntentSummary. Discard cannot be undone.
| Parameter | Type | Description |
|---|---|---|
| action * | string | one of ["inspect","discard","setup","videos","screen","save_content","save_location","save_ad_copy","save_budget"] |
| videoId | string | |
| artistId * | string | |
| pageToken | any | |
| adCopySave | object | |
| budgetSave | object | |
| campaignId | string |
Use only when the user explicitly requests a campaign change. Resume isn't available for fixed-flight YouTube campaigns. Duplicate the campaign to relaunch it. For pause, resume, archive and unarchive, first request phase=preview with one clientRequestId. Show that exact preview to the human; only after approval send phase=confirm with its expectedUpdatedAt, expectedCurrentStatus and (for resume) expectedFundingHash and the same request ID. Omitting phase never executes these status actions. Actions: pause, resume, update_budget, update_end_date (DAILY or TOTAL budget), update_location (GLOBAL or catalog-valid countries), change_strategy (managed YouTube Demand Gen), update_goals (YouTube optimization toggles), archive (never deletes), unarchive (restores PAUSED without funding or activating providers). Inspect the campaign first and supply expectedCurrentStatus where possible. When retrying the same action, reuse the same clientRequestId.
| Parameter | Type | Description |
|---|---|---|
| phase | string | Pause, resume, archive and reviewed budget changes require preview first; confirm only after the human approves that exact preview. |
| action * | string | one of ["pause","resume","update_budget","change_strategy","update_location","update_end_date","archive","unarchive","update_goals"] |
| endDate | string | Last day ads run |
| strategy | string | YouTube campaign strategy. Labels for users: CHEAPEST_VIEWS = Views, ORGANIC_VIEWS = Watch Time, SUBSCRIBERS = Subscribers, ORGANIC_VIEWS_AND_SUBSCRIBERS = Channel Growth (default for non-monetized channels), ADSENSE_ROI = Revenue (monetized channels only). Read dynamoi://youtube/campaign-strategies… |
| campaignId * |
Use this when the user wants to choose from uploaded images or videos that can be reused in a campaign launch. Do not use this when the user only wants campaign status or analytics. Use format=json when you need asset IDs for a follow-up launch. Request includeUrls only when the assistant must display or inspect public-safe asset URLs.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| cursor | string | |
| format | string | one of ["json","summary"] |
| artistId * | string | |
| includeUrls | boolean |
{
"name": "dynamoi_list_media_assets",
"title": "List Media Assets",
"description": "Use this when the user wants to choose from uploaded images or videos that can be reused in a campaign launch. Do not use this when the user only wants campaign status or analytics. Use format=json when you need asset IDs for a follow-up launch. Request includeUrls only when the assistant must display or inspect public-safe asset URLs.",
"inputSchema": {
"type": "object",
"required": [
"artistId"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1
},
"cursor": {
"type": "string"
},
"format": {
"enum": [
"json",
"summary"
],
"type": "string"
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"includeUrls": {
"type": "boolean"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"anyOf": [
{
"type": "object",
"required": [
"assets"
],
"properties": {
"assets": {
"type": "array",
"items": {
"type": "object",
"required": [
"createdAt",
"fileType",
"id"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"fileName": {
"type": "string"
},
"fileType": {
"type": "string"
},
"createdAt": {
"type": "string"
},
"moderation": {
"type": "object",
"required": [
"assetId",
"attemptCount",
"errorCode",
"errorMessage",
"fileType",
"provider",
"reasonCodes",
"riskLevel",
"scannedAt",
"status",
"summary",
"verdict"
],
"properties": {
"status": {
"enum": [
"NOT_REQUIRED",
"PENDING",
"SCANNING",
"APPROVED",
"NEEDS_REVIEW",
"BLOCKED",
"SCAN_FAILED",
"PROVIDER_UNAVAILABLE"
],
"type": "string"
},
"assetId": {
"type": "string"
},
"summary": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"verdict": {
"anyOf": [
{
"enum": [
"APPROVED",
"NEEDS_REVIEW",
"BLOCKED"
],
"type": "string"
},
{
"type": "null"
}
]
},
"fileType": {
"type": [
"string",
"null"
]
},
"provider": {
"anyOf": [
{
"enum": [
"GOOGLE_VISION_SAFESEARCH",
"GOOGLE_VIDEO_INTELLIGENCE_EXPLICIT",
"MANUAL_ADMIN",
"SPECIALIST_HASH_PROVIDER"
],
"type": "string"
},
{
"type": "null"
}
]
},
"errorCode": {
"type": [
"string",
"null"
]
},
"riskLevel": {
"anyOf": [
{
"enum": [
"NONE",
"LOW",
"MEDIUM",
"HIGH",
"SEVERE"
],
"type": "string"
},
{
"type": "null"
}
]
},
"scannedAt": {
"type": [
"string",
"null"
]
},
"reasonCodes": {
"type": "array",
"items": {
"type": "string"
}
},
"attemptCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"errorMessage": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"aspectRatio": {
"type": "string"
},
"thumbnailUrl": {
"type": "string"
},
"urlExpiresAt": {
"type": "string"
}
},
"additionalProperties": false
}
},
"nextCursor": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"summary",
"totalCount"
],
"properties": {
"summary": {
"type": "string"
},
"nextCursor": {
"type": "string"
},
"totalCount": {
"type": "number"
}
},
"additionalProperties": false
}
]
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}SMART_CAMPAIGN returns only a human-gated workspace handoff: it never saves these supplied compatibility fields, launches, authorizes funding or charges. Finish the current saved draft and confirm submission in that human flow. The following launch and funding instructions apply only to YOUTUBE. Use YOUTUBE only when the user explicitly wants to start its launch workflow. Ads are not necessarily live until the returned delivery state is ACTIVE. Every budget is funded from credit first, then prepaid funds, then the saved card. YOUTUBE campaigns require youtubeStrategy and either legacy youtubeVideoId/youtubePlaylistId or ordered youtubeEntries (up to 10 videoId/playlistId pairs); playlistId is optional for CHEAPEST_VIEWS, which supports one video. After a successful launch, answer from the returned campaign details directly instead of chaining more tools unless the user explicitly asked for more.
| Parameter | Type | Description |
|---|---|---|
| adCopy | string | |
| endDate | string | Last day ads run |
| artistId * | string | |
| budgetType * | string | one of ["DAILY","TOTAL"] |
| spotifyUrl | string | |
| contentType * | string | one of ["TRACK","ALBUM","PLAYLIST","VIDEO"] |
| budgetAmount * |
Use save_setup with setupSave={playLinkId, appleMusicUrl?} and a stable UUID-v4 setupRequestId per setup flow; reuse it on retries, and start a new flow for different content. It returns setupDraft. Use read_budget for budgetDraft and save_budget with budgetSave={campaignId, expectedUpdatedAt, budgetAmountCents, budgetAmountMinor?, currency?, budgetType:DAILY|TOTAL, endDate:YYYY-MM-DD|null}. Amounts are exact minor units in the artist currency; use the budget policy from read_budget. Setup and budget saves only edit drafts and never launch or charge. Use read_location to read native draft targeting and save_location with locationSave={campaignId, expectedUpdatedAt, targeting:{mode:WORLDWIDE}|{mode:INCLUDE,countryCodes:[US]}} to save it. Read locationDraft first for the current revision; both location actions return locationDraft. Read generation progress, generated creatives and current selection with action=read. To discover owned social posts, explicitly add catalog={source:facebook|instagram,limit:1..25,after?:nextCursor}. Only requested catalog reads fetch connected-account posts; use catalog.items[].id directly in selectedSocialPosts. Pass nextCursor as after for another page. Catalog reads never alter selections, token state, or campaigns; provider failure is an error, and selection revalidates ownership. Use start_generation, retry_generation or clear_generation with campaignId and expectedUpdatedAt from read. Generation runs asynchronously; poll with read. Use source_audio_upload_status or abort_source_audio_upload with campaignId, expectedUpdatedAt, uploadId and uploadSessionId to inspect uploaded parts or abort the direct upload. Agents never approve or submit. Use action=select with campaignId and expectedUpdatedAt from read, source=generate|posts|upload, and selectedCreativeIds, selectedSocialPosts (owned META:post IDs), or uploadedAssets=[{mediaAssetId}] from dynamoi_list_media_assets. Omit selectedCreativeIds for social or uploaded media. Uploaded metadata is resolved by the server; only owned, moderation-approved uploads can be selected. Selection never attests artist approval and never submits the campaign. Upload private JPEG/PNG/MP4 campaign media (1 GiB maximum) with start_media_upload, campaignId, expectedUpdatedAt and mediaUpload={assetId:UUID,fileName,fileSizeBytes,contentType}. Retain the returned key/uploadId and PUT each presigned part URL. Complete with complete_media_upload, a freshly inspected expectedUpdatedAt, and mediaUpload={assetId,fileName,fileSizeBytes,fileType,key,uploadId,parts:[{partNumber,etag}]}. Use media_upload_status or abort_media_upload with campaignId and mediaUpload={key,uploadId}; both remain usable after draft edits. A completed status means retry completion, not re-upload. Completion returns only a moderation receipt; poll dynamoi_list_media_assets and select only after APPROVED. Uploads do not edit the draft selection. Attach source MP3 audio to a draft with start_source_audio_upload, PUT each returned presigned part URL, then complete_source_audio_upload with the returned uploadId/uploadSessionId and part ETags. Both actions require campaignId, expectedUpdatedAt, fileSizeBytes, trackDurationSeconds and 0–2 hookSeconds. Read sourceAudio to confirm. Use import_source_audio with a public Dropbox share url, campaignId, expectedUpdatedAt, trackDurationSeconds and 0–2 hookSeconds (250 MiB maximum). Google Drive is unsupported because it requires a Google API key. On timeout or an ambiguous result, re-read sourceAudio before retrying.
Reopen an owned Smart or YouTube campaign draft with action=read_draft and campaignId. Returns its summary, current revision and reached step projections. Use action=read_media_catalog with mediaCatalog={source:uploads|facebook|instagram,limit:1..25,after?:nextCursor} for the native media chooser. Only authorized editors can use these setup reads. No draft, selection or campaign changes. Uploaded URLs stay hidden unless moderation approves them.
| Parameter | Type | Description |
|---|---|---|
| action * | string | one of ["read_draft","read_media_catalog"] |
| artistId * | string | |
| campaignId | string | |
| mediaCatalog | object |
{
"name": "dynamoi_read_campaign_draft_media",
"title": "Read Campaign Draft and Media",
"description": "Reopen an owned Smart or YouTube campaign draft with action=read_draft and campaignId. Returns its summary, current revision and reached step projections. Use action=read_media_catalog with mediaCatalog={source:uploads|facebook|instagram,limit:1..25,after?:nextCursor} for the native media chooser. Only authorized editors can use these setup reads. No draft, selection or campaign changes. Uploaded URLs stay hidden unless moderation approves them.",
"inputSchema": {
"type": "object",
"required": [
"action",
"artistId"
],
"properties": {
"action": {
"enum": [
"read_draft",
"read_media_catalog"
],
"type": "string"
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"campaignId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"mediaCatalog": {
"type": "object",
"required": [
"source"
],
"properties": {
"after": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 25,
"minimum": 1
},
"source": {
"enum": [
"facebook",
"instagram",
"uploads"
],
"type": "string"
}
}
}
},
"additionalProperties": false
},
"outputSchema": {
"truncated": true,
"chars": 27894
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read complete campaign media-moderation receipts for an authorized artist, with provider, status, scan time, risk and errors. Viewer access. Default page size 20, maximum 50; pass the opaque nextCursor for the next page. Approved public URLs are returned only when includeUrls=true. Read-only; never scans, overrides, selects or launches media.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| cursor | string | |
| artistId * | string | |
| includeUrls | boolean |
{
"name": "dynamoi_read_media_moderation",
"title": "Read Media Moderation Receipts",
"description": "Read complete campaign media-moderation receipts for an authorized artist, with provider, status, scan time, risk and errors. Viewer access. Default page size 20, maximum 50; pass the opaque nextCursor for the next page. Approved public URLs are returned only when includeUrls=true. Read-only; never scans, overrides, selects or launches media.",
"inputSchema": {
"type": "object",
"required": [
"artistId"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1
},
"cursor": {
"type": "string"
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"includeUrls": {
"type": "boolean"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"required": [
"assets"
],
"properties": {
"assets": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"createdAt",
"fileName",
"fileType",
"moderation"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"fileName": {
"type": "string"
},
"fileType": {
"type": "string"
},
"createdAt": {
"type": "string"
},
"moderation": {
"type": "object",
"required": [
"assetId",
"fileType",
"provider",
"status",
"verdict",
"riskLevel",
"reasonCodes",
"scannedAt",
"attemptCount",
"errorCode",
"errorMessage",
"summary"
],
"properties": {
"status": {
"enum": [
"NOT_REQUIRED",
"PENDING",
"SCANNING",
"APPROVED",
"NEEDS_REVIEW",
"BLOCKED",
"SCAN_FAILED",
"PROVIDER_UNAVAILABLE"
],
"type": "string"
},
"assetId": {
"type": "string"
},
"summary": {
"type": "null"
},
"verdict": {
"anyOf": [
{
"enum": [
"APPROVED",
"NEEDS_REVIEW",
"BLOCKED"
],
"type": "string"
},
{
"type": "null"
}
]
},
"fileType": {
"type": [
"string",
"null"
]
},
"provider": {
"anyOf": [
{
"enum": [
"GOOGLE_VISION_SAFESEARCH",
"GOOGLE_VIDEO_INTELLIGENCE_EXPLICIT",
"MANUAL_ADMIN",
"SPECIALIST_HASH_PROVIDER"
],
"type": "string"
},
{
"type": "null"
}
]
},
"errorCode": {
"type": [
"string",
"null"
]
},
"riskLevel": {
"anyOf": [
{
"enum": [
"NONE",
"LOW",
"MEDIUM",
"HIGH",
"SEVERE"
],
"type": "string"
},
{
"type": "null"
}
]
},
"scannedAt": {
"type": [
"string",
"null"
]
},
"reasonCodes": {
"type": "array",
"items": {
"type": "string"
}
},
"attemptCount": {
"type": "number"
},
"errorMessage": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"aspectRatio": {
"type": "string"
},
"thumbnailUrl": {
"type": "string"
}
},
"additionalProperties": false
}
},
"nextCursor": {
"type": "string"
}
},
"additionalProperties": false
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Prepare metadata, tracks and proposed splits for artist review in a private expiring web form. Does not submit a release, attest rights, accept agreements or invite collaborators.
| Parameter | Type | Description |
|---|---|---|
| notes * | ["string","null"] | |
| splits * | array | |
| tracks * | array | |
| artistId * | string | |
| labelName * | ["string","null"] | |
| releaseType * | string | |
| releaseTitle * | string | |
| hasCollaborators * | boolean | |
| desiredReleaseDate * | string |
Read native foundation, application, agreement, catalog or release status for an accessible artist through the same owners as web/mobile. Release intake status requires editor access, as on web; catalog retains viewer scoping. Catalog is a status overview; releases returns the latest 20 submissions, not complete history. Rights and agreement attestation and sending releases to stores are done by the artist in web or the app.
| Parameter | Type | Description |
|---|---|---|
| section * | string | one of ["application","agreement","catalog","releases","foundation"] |
| artistId * | string |
{
"name": "dynamoi_get_distribution_status",
"title": "Read Distribution Status",
"description": "Read native foundation, application, agreement, catalog or release status for an accessible artist through the same owners as web/mobile. Release intake status requires editor access, as on web; catalog retains viewer scoping. Catalog is a status overview; releases returns the latest 20 submissions, not complete history. Rights and agreement attestation and sending releases to stores are done by the artist in web or the app.",
"inputSchema": {
"type": "object",
"required": [
"artistId",
"section"
],
"properties": {
"section": {
"enum": [
"application",
"agreement",
"catalog",
"releases",
"foundation"
],
"type": "string"
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Use this for "get my music on Spotify" or "distribute my song": Dynamoi distributes to 100+ stores and artists keep 90% of net receipts. Use this when the user asks whether an artist qualifies for Dynamoi music distribution, wants the five application requirements, or wants the status of an existing distribution application. It checks Spotify connection, at least 1,000 Spotify followers, at least 10,000 verified monthly listeners, connected Facebook Page plus Instagram professional identity, and a connected YouTube channel. Meeting all five requirements permits an application but never guarantees approval. When the connection tools are available, use purpose=distribution_identity for missing Meta or YouTube identity; otherwise tell the user: 'You can do this in the Dynamoi dashboard at https://dynamoi.com/dashboard.' Identity connections do not require advertising billing.
| Parameter | Type | Description |
|---|---|---|
| artistId * | string |
{
"name": "dynamoi_get_distribution_application",
"title": "Check Distribution Application",
"description": "Use this for \"get my music on Spotify\" or \"distribute my song\": Dynamoi distributes to 100+ stores and artists keep 90% of net receipts. Use this when the user asks whether an artist qualifies for Dynamoi music distribution, wants the five application requirements, or wants the status of an existing distribution application. It checks Spotify connection, at least 1,000 Spotify followers, at least 10,000 verified monthly listeners, connected Facebook Page plus Instagram professional identity, and a connected YouTube channel. Meeting all five requirements permits an application but never guarantees approval. When the connection tools are available, use purpose=distribution_identity for missing Meta or YouTube identity; otherwise tell the user: 'You can do this in the Dynamoi dashboard at https://dynamoi.com/dashboard.' Identity connections do not require advertising billing.",
"inputSchema": {
"type": "object",
"required": [
"artistId"
],
"properties": {
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Submit an artist's application for Dynamoi music distribution after the user explicitly asks to apply and all five eligibility requirements are met. This records an application for manual review; it does not approve distribution, accept an agreement, submit a release, transfer rights, configure splits or tax forms, or deliver music to stores. All three valid ISO 3166-1 alpha-2 country or territory codes, an adult signer attestation, confirmApplicationSubmission=true, and a concise userIntentSummary are required. Country, tax, payout, sanctions, and provider-delivery checks remain manual progression gates after intake; a valid code does not imply approval. Repeated submission is idempotent for an active application.
| Parameter | Type | Description |
|---|---|---|
| artistId * | string | |
| payoutCountry * | string | |
| applicantCountry * | string | |
| userIntentSummary * | string | |
| taxResidencyCountry * | string | |
| adultSignerAttestation * | boolean | |
| confirmApplicationSubmission * |
Read up to 20 newest Shop orders for an authorized artist, optionally filtered by order ID. Returns observed order status, independent remedy outcome, campaign status and fulfillment timestamps. No refunds or fulfillment changes.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| orderId | string | |
| artistId * | string |
{
"name": "dynamoi_shop_list_orders",
"title": "Read Shop Orders",
"description": "Read up to 20 newest Shop orders for an authorized artist, optionally filtered by order ID. Returns observed order status, independent remedy outcome, campaign status and fulfillment timestamps. No refunds or fulfillment changes.",
"inputSchema": {
"type": "object",
"required": [
"artistId"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 20,
"minimum": 1
},
"orderId": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"artistId": {
"type": "string",
"maxLength": 255,
"minLength": 1
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"anyOf": [
{
"type": "object",
"required": [
"data",
"status"
],
"properties": {
"data": {
"type": "object",
"required": [
"orders"
],
"properties": {
"orders": {
"type": "array",
"items": {
"type": "object",
"required": [
"campaignStatus",
"completedAt",
"createdAt",
"deploymentCompletedAt",
"orderId",
"status"
],
"properties": {
"status": {
"type": "string"
},
"orderId": {
"type": "string"
},
"createdAt": {
"type": "string"
},
"completedAt": {
"type": [
"string",
"null"
]
},
"remedyOutcome": {
"anyOf": [
{
"enum": [
"full_refund",
"partial_refund",
"no_refund"
],
"type": "string"
},
{
"type": "null"
}
]
},
"campaignStatus": {
"type": [
"string",
"null"
]
},
"deploymentCompletedAt": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"maxItems": 20
}
},
"additionalProperties": false
},
"status": {
"type": "string",
"const": "success"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"message",
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"type": "string",
"const": "error"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string",
"minLength": 1
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
}
]
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Calculate a read-only Dynamoi Shop estimate for a one-off YouTube video promotion. The server derives storefront price, currency, targeting, and estimated views. The YouTube video is optional: omit youtubeUrl to add it after payment. This does not reserve a price, create checkout, collect payment, create an order, or launch a campaign.
| Parameter | Type | Description |
|---|---|---|
| selection * | any | |
| targeting * | any | |
| youtubeUrl | any | |
| marketLocale * | string | |
| storefrontSlug * | string |
{
"name": "dynamoi_shop_get_quote",
"title": "Get Shop Promotion Estimate",
"description": "Calculate a read-only Dynamoi Shop estimate for a one-off YouTube video promotion. The server derives storefront price, currency, targeting, and estimated views. The YouTube video is optional: omit youtubeUrl to add it after payment. This does not reserve a price, create checkout, collect payment, create an order, or launch a campaign.",
"inputSchema": {
"type": "object",
"required": [
"marketLocale",
"selection",
"storefrontSlug",
"targeting"
],
"properties": {
"selection": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"tier"
],
"properties": {
"kind": {
"type": "string",
"const": "package"
},
"tier": {
"enum": [
"starter",
"standard",
"premium"
],
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"campaignDurationDays",
"kind",
"targetViews"
],
"properties": {
"kind": {
"type": "string",
"const": "custom"
},
"targetViews": {
"type": "integer",
"maximum": 1000000,
"minimum": 25000
},
"campaignDurationDays": {
"type": "integer",
"maximum": 30,
"minimum": 7
}
},
"additionalProperties": false
}
]
},
"targeting": {
"oneOf": [
{
"type": "object",
"required": [
"mode"
],
"properties": {
"mode": {
"type": "string",
"const": "GLOBAL"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"countryCodes",
"mode"
],
"properties": {
"mode": {
"type": "string",
"const": "INCLUDE"
},
"countryCodes": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"maxItems": 50,
"minItems": 1
}
},
"additionalProperties": false
}
]
},
"youtubeUrl": {
"anyOf": [
{
"type": "string",
"const": ""
},
{
"type": "string",
"const": "pending"
},
{
"type": "string",
"format": "uri",
"maxLength": 500
}
]
},
"marketLocale": {
"type": "string",
"maxLength": 35,
"minLength": 2
},
"storefrontSlug": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
"maxLength": 160,
"minLength": 1
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"anyOf": [
{
"type": "object",
"required": [
"data",
"status"
],
"properties": {
"data": {
"type": "object",
"required": [
"campaignDurationDays",
"estimatedViews",
"kind",
"reviewRequired",
"selection",
"storefront",
"targeting",
"total",
"video"
],
"properties": {
"kind": {
"type": "string",
"const": "shop_quote"
},
"total": {
"type": "object",
"required": [
"amountMinor",
"currency",
"formatted"
],
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"formatted": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"amountMinor": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"video": {
"anyOf": [
{
"type": "object",
"required": [
"normalizedUrl",
"videoId"
],
"properties": {
"videoId": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{11}$"
},
"normalizedUrl": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"selection": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"tier"
],
"properties": {
"kind": {
"type": "string",
"const": "package"
},
"tier": {
"enum": [
"starter",
"standard",
"premium"
],
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"campaignDurationDays",
"kind",
"targetViews"
],
"properties": {
"kind": {
"type": "string",
"const": "custom"
},
"targetViews": {
"type": "integer",
"maximum": 1000000,
"minimum": 25000
},
"campaignDurationDays": {
"type": "integer",
"maximum": 30,
"minimum": 7
}
},
"additionalProperties": false
}
]
},
"targeting": {
"oneOf": [
{
"type": "object",
"required": [
"mode"
],
"properties": {
"mode": {
"type": "string",
"const": "GLOBAL"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"countryCodes",
"mode"
],
"properties": {
"mode": {
"type": "string",
"const": "INCLUDE"
},
"countryCodes": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"minItems": 1
}
},
"additionalProperties": false
}
]
},
"storefront": {
"type": "object",
"required": [
"currency",
"marketLocale",
"slug"
],
"properties": {
"slug": {
"type": "string"
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"marketLocale": {
"type": "string"
}
},
"additionalProperties": false
},
"estimatedViews": {
"anyOf": [
{
"type": "object",
"required": [
"basis",
"max",
"min",
"notGuaranteed"
],
"properties": {
"max": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"min": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"basis": {
"type": "string",
"const": "rolling_30_day_cpv"
},
"notGuaranteed": {
"type": "boolean",
"const": true
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"reviewRequired": {
"type": "boolean"
},
"campaignDurationDays": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"status": {
"type": "string",
"const": "success"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"message",
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"type": "string",
"const": "error"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string",
"minLength": 1
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
}
]
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}After explicit user intent, revalidate and re-quote a one-off Dynamoi Shop YouTube promotion and create an unpaid Stripe Checkout Session. The expected total is a compare-and-reject guard, never a price instruction. This does not charge the user, create an order, or launch a campaign; the user must open and complete Stripe Checkout.
| Parameter | Type | Description |
|---|---|---|
| promotion * | object | |
| requestId * | string | |
| expectedTotal * | object |
{
"name": "dynamoi_shop_create_checkout",
"title": "Create Unpaid Shop Checkout",
"description": "After explicit user intent, revalidate and re-quote a one-off Dynamoi Shop YouTube promotion and create an unpaid Stripe Checkout Session. The expected total is a compare-and-reject guard, never a price instruction. This does not charge the user, create an order, or launch a campaign; the user must open and complete Stripe Checkout.",
"inputSchema": {
"type": "object",
"required": [
"expectedTotal",
"promotion",
"requestId"
],
"properties": {
"promotion": {
"type": "object",
"required": [
"marketLocale",
"selection",
"storefrontSlug",
"targeting"
],
"properties": {
"selection": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"tier"
],
"properties": {
"kind": {
"type": "string",
"const": "package"
},
"tier": {
"enum": [
"starter",
"standard",
"premium"
],
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"campaignDurationDays",
"kind",
"targetViews"
],
"properties": {
"kind": {
"type": "string",
"const": "custom"
},
"targetViews": {
"type": "integer",
"maximum": 1000000,
"minimum": 25000
},
"campaignDurationDays": {
"type": "integer",
"maximum": 30,
"minimum": 7
}
},
"additionalProperties": false
}
]
},
"targeting": {
"oneOf": [
{
"type": "object",
"required": [
"mode"
],
"properties": {
"mode": {
"type": "string",
"const": "GLOBAL"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"countryCodes",
"mode"
],
"properties": {
"mode": {
"type": "string",
"const": "INCLUDE"
},
"countryCodes": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"maxItems": 50,
"minItems": 1
}
},
"additionalProperties": false
}
]
},
"youtubeUrl": {
"anyOf": [
{
"type": "string",
"const": ""
},
{
"type": "string",
"const": "pending"
},
{
"type": "string",
"format": "uri",
"maxLength": 500
}
]
},
"marketLocale": {
"type": "string",
"maxLength": 35,
"minLength": 2
},
"storefrontSlug": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
"maxLength": 160,
"minLength": 1
}
},
"additionalProperties": false
},
"requestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"expectedTotal": {
"type": "object",
"required": [
"amountMinor",
"currency"
],
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"amountMinor": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"anyOf": [
{
"type": "object",
"required": [
"data",
"status"
],
"properties": {
"data": {
"type": "object",
"required": [
"checkoutUrl",
"expiresAt",
"kind",
"orderCreated",
"paymentCompleted",
"status",
"total"
],
"properties": {
"kind": {
"type": "string",
"const": "shop_checkout"
},
"total": {
"type": "object",
"required": [
"amountMinor",
"currency",
"formatted"
],
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"formatted": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"amountMinor": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"status": {
"type": "string",
"const": "checkout_required"
},
"expiresAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"checkoutUrl": {
"type": "string",
"format": "uri"
},
"orderCreated": {
"type": "boolean",
"const": false
},
"paymentCompleted": {
"type": "boolean",
"const": false
}
},
"additionalProperties": false
},
"status": {
"type": "string",
"const": "success"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"message",
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"type": "string",
"const": "error"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string",
"minLength": 1
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
}
]
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Read the authorized artist's buyer-safe purchase history, 10 orders per page. Pass nextCursor as before for continuation. Uses the same localized dates, client price labels and order/remedy display states as the web. Informational read only; no refunds, provider IDs or fulfillment changes.
| Parameter | Type | Description |
|---|---|---|
| before | any | |
| locale * | string | |
| artistId * | string | |
| selectedOrderId | any |
{
"name": "dynamoi_get_shop_purchase_history",
"title": "Read Shop Purchase History",
"description": "Read the authorized artist's buyer-safe purchase history, 10 orders per page. Pass nextCursor as before for continuation. Uses the same localized dates, client price labels and order/remedy display states as the web. Informational read only; no refunds, provider IDs or fulfillment changes.",
"inputSchema": {
"type": "object",
"required": [
"locale",
"artistId"
],
"properties": {
"before": {
"anyOf": [
{
"type": "object",
"required": [
"createdAtISO",
"orderId"
],
"properties": {
"orderId": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"createdAtISO": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"default": null
},
"locale": {
"type": "string",
"maxLength": 30,
"minLength": 2
},
"artistId": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"selectedOrderId": {
"anyOf": [
{
"type": "string",
"maxLength": 255
},
{
"type": "null"
}
],
"default": null
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"required": [
"nextCursor",
"rows"
],
"properties": {
"rows": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"orderReferenceLabel",
"campaignId",
"dateISO",
"dateLabel",
"endDateISO",
"endDateLabel",
"videoTitle",
"thumbnailUrl",
"packageTierLabel",
"amountCents",
"amountLabel",
"statusLabel",
"statusTone",
"isSelected"
],
"properties": {
"id": {
"type": "string"
},
"dateISO": {
"type": "string"
},
"dateLabel": {
"type": "string"
},
"campaignId": {
"type": [
"string",
"null"
]
},
"endDateISO": {
"type": [
"string",
"null"
]
},
"isSelected": {
"type": "boolean"
},
"statusTone": {
"type": "string"
},
"videoTitle": {
"type": "string"
},
"amountCents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"amountLabel": {
"type": "string"
},
"statusLabel": {
"type": "string"
},
"endDateLabel": {
"type": "string"
},
"thumbnailUrl": {
"type": [
"string",
"null"
]
},
"packageTierLabel": {
"type": "string"
},
"orderReferenceLabel": {
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 10
},
"nextCursor": {
"anyOf": [
{
"type": "object",
"required": [
"createdAtISO",
"orderId"
],
"properties": {
"orderId": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"createdAtISO": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Attach the first video to an authorized paid order; existing channel ownership and order-to-artist move rules apply. Requires editor access and full profile. Preview, review with the user, then confirm using the same clientRequestId and expectedOrderState. Reuse the original ID to reconcile an uncertain result. Does not charge or refund.
| Parameter | Type | Description |
|---|---|---|
| phase | string | one of ["preview","confirm"] |
| artistId * | string | |
| youtubeUrl * | string | |
| shopOrderId * | string | |
| clientRequestId * | string | |
| expectedOrderState | string |
{
"name": "dynamoi_attach_shop_order_video",
"title": "Attach Shop Order Video",
"description": "Attach the first video to an authorized paid order; existing channel ownership and order-to-artist move rules apply. Requires editor access and full profile. Preview, review with the user, then confirm using the same clientRequestId and expectedOrderState. Reuse the original ID to reconcile an uncertain result. Does not charge or refund.",
"inputSchema": {
"type": "object",
"required": [
"shopOrderId",
"youtubeUrl",
"clientRequestId",
"artistId"
],
"properties": {
"phase": {
"enum": [
"preview",
"confirm"
],
"type": "string",
"default": "preview"
},
"artistId": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"youtubeUrl": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"shopOrderId": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"clientRequestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"expectedOrderState": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"required": [
"phase"
],
"properties": {
"phase": {
"enum": [
"preview",
"confirmed"
],
"type": "string"
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"attached",
"queued",
"duplicate",
"launch_failed"
],
"type": "string"
},
"expected": {
"type": "object",
"required": [
"expectedOrderState"
],
"properties": {
"expectedOrderState": {
"type": "string"
}
},
"additionalProperties": false
},
"proposed": {
"type": "object",
"properties": {
"phase": {
"enum": [
"preview",
"confirm"
],
"type": "string",
"default": "preview"
},
"campaignId": {
"type": "string"
},
"youtubeUrl": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"shopOrderId": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"clientRequestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"expectedOrderState": {
"type": "string"
}
},
"additionalProperties": false
},
"destination": {
"anyOf": [
{
"type": "object",
"required": [
"artistId",
"artistSlug",
"organizationSlug"
],
"properties": {
"artistId": {
"type": "string"
},
"artistSlug": {
"type": "string"
},
"organizationSlug": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"validationCode": {
"type": "string"
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Replace a rejected video only when the existing policy replacement offer is active; preserves the original paid budget and targeting. Requires editor access and full profile. Preview, review with the user, then confirm using the same clientRequestId and expectedOrderState. Reuse the original ID to reconcile an uncertain result. Does not charge or refund.
| Parameter | Type | Description |
|---|---|---|
| phase | string | one of ["preview","confirm"] |
| artistId * | string | |
| campaignId * | string | |
| youtubeUrl * | string | |
| shopOrderId * | string | |
| clientRequestId * | string | |
| expectedOrderState | string |
{
"name": "dynamoi_replace_shop_promotion_video",
"title": "Replace Shop Promotion Video",
"description": "Replace a rejected video only when the existing policy replacement offer is active; preserves the original paid budget and targeting. Requires editor access and full profile. Preview, review with the user, then confirm using the same clientRequestId and expectedOrderState. Reuse the original ID to reconcile an uncertain result. Does not charge or refund.",
"inputSchema": {
"type": "object",
"required": [
"shopOrderId",
"youtubeUrl",
"clientRequestId",
"campaignId",
"artistId"
],
"properties": {
"phase": {
"enum": [
"preview",
"confirm"
],
"type": "string",
"default": "preview"
},
"artistId": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"campaignId": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"youtubeUrl": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"shopOrderId": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"clientRequestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"expectedOrderState": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"required": [
"phase"
],
"properties": {
"phase": {
"enum": [
"preview",
"confirmed"
],
"type": "string"
},
"message": {
"type": "string"
},
"outcome": {
"enum": [
"attached",
"queued",
"duplicate",
"launch_failed"
],
"type": "string"
},
"expected": {
"type": "object",
"required": [
"expectedOrderState"
],
"properties": {
"expectedOrderState": {
"type": "string"
}
},
"additionalProperties": false
},
"proposed": {
"type": "object",
"properties": {
"phase": {
"enum": [
"preview",
"confirm"
],
"type": "string",
"default": "preview"
},
"campaignId": {
"type": "string"
},
"youtubeUrl": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"shopOrderId": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"clientRequestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"expectedOrderState": {
"type": "string"
}
},
"additionalProperties": false
},
"destination": {
"anyOf": [
{
"type": "object",
"required": [
"artistId",
"artistSlug",
"organizationSlug"
],
"properties": {
"artistId": {
"type": "string"
},
"artistSlug": {
"type": "string"
},
"organizationSlug": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"validationCode": {
"type": "string"
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Read a custom promotion price and view estimate for an artist you can access, using the same returning-buyer offer and viewer-location rules as the website. Keep this market locale and currency when preparing checkout. Returned ranges already include any eligible offer; do not add a bonus again. No price is reserved.
| Parameter | Type | Description |
|---|---|---|
| artistId * | string | |
| currency * | string | |
| countryMode | string | one of ["GLOBAL","INCLUDE"] |
| targetViews * | integer | |
| countryCodes | array | |
| marketLocale * | string | |
| budgetAmountMajor | any |
{
"name": "dynamoi_quote_shop_rebuy_custom",
"title": "Quote Returning Buyer Custom Promotion",
"description": "Read a custom promotion price and view estimate for an artist you can access, using the same returning-buyer offer and viewer-location rules as the website. Keep this market locale and currency when preparing checkout. Returned ranges already include any eligible offer; do not add a bonus again. No price is reserved.",
"inputSchema": {
"type": "object",
"required": [
"currency",
"marketLocale",
"targetViews",
"artistId"
],
"properties": {
"artistId": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"countryMode": {
"enum": [
"GLOBAL",
"INCLUDE"
],
"type": "string",
"default": "GLOBAL"
},
"targetViews": {
"type": "integer",
"maximum": 1000000,
"minimum": 25000
},
"countryCodes": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"default": [],
"maxItems": 50
},
"marketLocale": {
"type": "string",
"maxLength": 30,
"minLength": 2
},
"budgetAmountMajor": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"required": [
"quote"
],
"properties": {
"quote": {
"type": "object",
"required": [
"amountCents",
"currency",
"estimatedViews",
"pricingVersion",
"reviewRequired",
"targetViews"
],
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"amountCents": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"targetViews": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"estimatedViews": {
"type": "object",
"required": [
"min",
"max"
],
"properties": {
"max": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"min": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
"pricingVersion": {
"type": "string",
"const": "custom-campaign-v2"
},
"reviewRequired": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read view estimates for up to ten package prices using the same returning-buyer offer and viewer-location rules as the website. Returned ranges already include any eligible offer; do not add a bonus again. No price is reserved.
| Parameter | Type | Description |
|---|---|---|
| budgets * | array | |
| artistId * | string | |
| currency * | string | |
| countryMode | string | one of ["GLOBAL","INCLUDE"] |
| countryCodes | array | |
| marketLocale * | string |
{
"name": "dynamoi_estimate_shop_rebuy_packages",
"title": "Estimate Returning Buyer Packages",
"description": "Read view estimates for up to ten package prices using the same returning-buyer offer and viewer-location rules as the website. Returned ranges already include any eligible offer; do not add a bonus again. No price is reserved.",
"inputSchema": {
"type": "object",
"required": [
"currency",
"marketLocale",
"budgets",
"artistId"
],
"properties": {
"budgets": {
"type": "array",
"items": {
"type": "object",
"required": [
"key",
"budgetCents"
],
"properties": {
"key": {
"type": "string",
"maxLength": 64,
"minLength": 1
},
"budgetCents": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"maxItems": 10,
"minItems": 1
},
"artistId": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"countryMode": {
"enum": [
"GLOBAL",
"INCLUDE"
],
"type": "string",
"default": "GLOBAL"
},
"countryCodes": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"default": [],
"maxItems": 50
},
"marketLocale": {
"type": "string",
"maxLength": 30,
"minLength": 2
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"required": [
"estimates"
],
"properties": {
"estimates": {
"type": "array",
"items": {
"type": "object",
"required": [
"key",
"estimatedViews",
"checkoutAvailable",
"targetingIssue"
],
"properties": {
"key": {
"type": "string"
},
"estimatedViews": {
"type": "object",
"required": [
"min",
"max"
],
"properties": {
"max": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"min": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
"targetingIssue": {
"anyOf": [
{
"type": "string",
"const": "broaden_targeting_required"
},
{
"type": "null"
}
]
},
"checkoutAvailable": {
"type": "boolean"
}
},
"additionalProperties": false
},
"maxItems": 10
}
},
"additionalProperties": false
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Preview the selected video, viewer locations and expected total. Use the quote market locale as locale. Confirm only after user approval, keeping the same clientRequestId and expectedTotal. Before opening unpaid Stripe Checkout, Dynamoi checks the current total and applies its existing buyer-offer and purchase-email rules. Creating checkout does not pay, create an order or launch a promotion. Reconcile uncertain outcomes with the original request ID and exact input.
| Parameter | Type | Description |
|---|---|---|
| tier * | string | |
| phase | string | one of ["preview","confirm"] |
| locale * | string | |
| artistId * | string | |
| shopSlug * | string | |
| youtubeUrl * | string | |
| countryMode | string | one of ["GLOBAL","INCLUDE"] |
| countryCodes | array | |
| contentLocale | string |
Preview a Shop promotion pause. Requires editor access and full profile. Inspect the preview with the user, then confirm with the same clientRequestId and expectedCampaignStatus. Existing paid-order, provider and restart safeguards remain authoritative. Restart requires youtubeUrl and targetingConfirmed=true. Queues the existing job; no payment or refund. Reuse the original request ID when reconciling an uncertain result.
| Parameter | Type | Description |
|---|---|---|
| phase | string | one of ["preview","confirm"] |
| artistId * | string | |
| campaignId * | string | |
| youtubeUrl | string | |
| shopOrderId * | string | |
| clientRequestId * | string | |
| targetingConfirmed | boolean | |
| expectedCampaignStatus | string |
Preview a Shop promotion resume. Requires editor access and full profile. Inspect the preview with the user, then confirm with the same clientRequestId and expectedCampaignStatus. Existing paid-order, provider and restart safeguards remain authoritative. Restart requires youtubeUrl and targetingConfirmed=true. Queues the existing job; no payment or refund. Reuse the original request ID when reconciling an uncertain result.
| Parameter | Type | Description |
|---|---|---|
| phase | string | one of ["preview","confirm"] |
| artistId * | string | |
| campaignId * | string | |
| youtubeUrl | string | |
| shopOrderId * | string | |
| clientRequestId * | string | |
| targetingConfirmed | boolean | |
| expectedCampaignStatus | string |
Preview a Shop promotion restart. Requires editor access and full profile. Inspect the preview with the user, then confirm with the same clientRequestId and expectedCampaignStatus. Existing paid-order, provider and restart safeguards remain authoritative. Restart requires youtubeUrl and targetingConfirmed=true. Queues the existing job; no payment or refund. Reuse the original request ID when reconciling an uncertain result.
| Parameter | Type | Description |
|---|---|---|
| phase | string | one of ["preview","confirm"] |
| artistId * | string | |
| campaignId * | string | |
| youtubeUrl * | string | |
| shopOrderId * | string | |
| clientRequestId * | string | |
| targetingConfirmed * | boolean | |
| expectedCampaignStatus | string |
Use this when the user wants to report a problem with Dynamoi (a tool error, sign-in or permission problem, wrong data, a billing, campaign or distribution question) or send Dynamoi feedback. Show the user the subject and message and get their OK before sending. Dynamoi attaches the signed-in account and this agent's identity, and support replies by email to the account address. Never include passwords, tokens, API keys or card numbers. Sending changes no campaign, billing or account data.
| Parameter | Type | Description |
|---|---|---|
| message * | string | |
| subject * | string | |
| category * | string | one of ["sign_in","tool_error","billing","campaign","distribution","smart_links","feedback","other"] |
| requestId | string | Reuse this ID when retrying the same request; use a new ID for a new request. |
| failedTool | string | |
| errorMessage | string |
{
"name": "dynamoi_contact_support",
"title": "Contact Dynamoi Support",
"description": "Use this when the user wants to report a problem with Dynamoi (a tool error, sign-in or permission problem, wrong data, a billing, campaign or distribution question) or send Dynamoi feedback. Show the user the subject and message and get their OK before sending. Dynamoi attaches the signed-in account and this agent's identity, and support replies by email to the account address. Never include passwords, tokens, API keys or card numbers. Sending changes no campaign, billing or account data.",
"inputSchema": {
"type": "object",
"required": [
"category",
"message",
"subject"
],
"properties": {
"message": {
"type": "string",
"maxLength": 4000,
"minLength": 10
},
"subject": {
"type": "string",
"maxLength": 150,
"minLength": 3
},
"category": {
"enum": [
"sign_in",
"tool_error",
"billing",
"campaign",
"distribution",
"smart_links",
"feedback",
"other"
],
"type": "string"
},
"requestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Reuse this ID when retrying the same request; use a new ID for a new request."
},
"failedTool": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]{0,63}$"
},
"errorMessage": {
"type": "string",
"maxLength": 1000
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"required": [
"kind",
"reference",
"replyChannel",
"status"
],
"properties": {
"kind": {
"type": "string",
"const": "support_request"
},
"status": {
"type": "string",
"const": "received"
},
"reference": {
"type": "string",
"minLength": 1
},
"replyChannel": {
"type": "string",
"const": "account_email"
}
},
"additionalProperties": false
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}
}Use this to tell Dynamoi when a tool failed, confused you, or lacked something you needed. It is stored with the user's account. Describe the problem generically and leave out names, emails, links and IDs.
| Parameter | Type | Description |
|---|---|---|
| kind * | string | one of ["tool_problem","confusing_result","missing_feature","docs_or_instructions","praise","other"] |
| wish | string | |
| summary * | string | |
| severity | string | one of ["low","medium","high"] |
| toolName | string | |
| clientContext | string |
{
"name": "dynamoi_send_feedback",
"title": "Send Dynamoi Feedback",
"description": "Use this to tell Dynamoi when a tool failed, confused you, or lacked something you needed. It is stored with the user's account. Describe the problem generically and leave out names, emails, links and IDs.",
"inputSchema": {
"type": "object",
"required": [
"kind",
"summary"
],
"properties": {
"kind": {
"enum": [
"tool_problem",
"confusing_result",
"missing_feature",
"docs_or_instructions",
"praise",
"other"
],
"type": "string"
},
"wish": {
"type": "string",
"maxLength": 500
},
"summary": {
"type": "string",
"maxLength": 500,
"minLength": 3
},
"severity": {
"enum": [
"low",
"medium",
"high"
],
"type": "string"
},
"toolName": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]{0,63}$"
},
"clientContext": {
"type": "string",
"maxLength": 120
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"required": [
"message",
"status"
],
"properties": {
"status": {
"type": "string",
"const": "recorded"
},
"message": {
"type": "string",
"const": "Thanks — recorded."
}
},
"additionalProperties": false
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Use this when the user asks what Dynamoi Smart Link pages can look like, wants to compare Smart Link themes, or asks to preview the available themes before creating or updating a free Smart Link. This is a read-only visual preview and does not create, publish, update, or promote a Smart Link.
| Parameter | Type | Description |
|---|---|---|
| artistName | string | |
| releaseTitle | string |
{
"name": "dynamoi_preview_smart_link_themes",
"title": "Preview Smart Link Themes",
"description": "Use this when the user asks what Dynamoi Smart Link pages can look like, wants to compare Smart Link themes, or asks to preview the available themes before creating or updating a free Smart Link. This is a read-only visual preview and does not create, publish, update, or promote a Smart Link.",
"inputSchema": {
"type": "object",
"properties": {
"artistName": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"releaseTitle": {
"type": "string",
"maxLength": 80,
"minLength": 1
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Use this for "make a link for my song" or a release or link-in-bio page for a new single. Use this when the user wants to create one free Dynamoi Smart Link from a Spotify album or track URL/URI, or a single starter release from a Spotify artist URL. For full-catalog artist imports or artist hub requests, prefer dynamoi_create_smart_links_from_spotify_artist. Smart Links are free to create and manage. High-popularity or unverifiable artist links may stay unpublished in verification hold until Dynamoi can verify the client relationship. This does not create a paid ad campaign. Spotify playlist URLs are not supported today. This is also how to add a release missing from an artist's imported catalog: the user pastes that release's exact Spotify album, single, or EP URL. If the Smart Link already exists, return the existing link instead of creating a duplicate; if customDescription is provided, update that Smart Link's public description. In the final answer, lead with the public URL and do not expose internal IDs unless asked.
| Parameter | Type | Description |
|---|---|---|
| format | string | one of ["json","summary"] |
| artistId * | string | |
| spotifyUrl * | string | |
| clientRequestId | string | |
| customDescription | string | |
| userIntentSummary | string |
Preview at most 25 Spotify album/single Smart Links, then show the exact count, titles and existing/new counts to the user. Creation requires a separate confirmed call with phase=confirm, the returned previewId and confirmedCount matching count. Preview creates no artist or Smart Links. Omit artistId to create the first artist only after confirmation. The target list is frozen; one confirmation never starts an unbounded catalog job. A nextOffset requires a new preview and confirmation. Retain the exact original request and clientRequestId for replay, including the original short URL. Replays observe the saved plan before URL resolution. First-artist previews include the reviewed workspace and confirmation cannot choose another. Only settlement=expired_before_execution proves an expired preview started no catalog writes; a generic conflict, timeout or local expiry does not. An in-progress or ambiguous result retains its key and never starts another write. Smart Links are free and may remain in verification hold. Lead with public URLs; this does not create a paid campaign.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| phase | string | one of ["preview","confirm"] |
| format | string | one of ["json","summary"] |
| offset | integer | |
| artistId | string | |
| previewId | string | |
| confirmedCount | integer |
Use this when the user wants to list free Smart Links for one artist, including release title, public URL, publish state, claim state, render state, and theme. Do not use this for paid campaign lists; use dynamoi_list_campaigns for campaigns. In the final answer, show public URLs and avoid internal IDs unless asked. If empty for an artist with connected Spotify, suggest dynamoi_create_smart_links_from_spotify_artist for catalog import or dynamoi_create_smart_link_from_spotify for one release instead of stopping at 'no Smart Links yet'.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| query | string | |
| cursor | string | |
| format | string | one of ["json","summary"] |
| artistId * | string | |
| claimStatus | string | one of ["auto_approved","pending_ops_review","verification_deferred","approved_by_ops","rejected"] |
| renderState | string | one of ["queued","rendering","rendered","failed"] |
| publishState | string | one of ["published","unpublished"] |
Use this when the user wants full details for one free Smart Link, including release, Spotify URL, public play.dynamoi.com URL, current status, theme source, and next actions. Set includeAnalytics=true for visit/click analytics and includeArtistSettings=true for artist-level theme/pixel settings. In the final answer, lead with the public URL and do not expose internal IDs unless asked.
| Parameter | Type | Description |
|---|---|---|
| format | string | one of ["json","summary"] |
| artistId | string | |
| dateRange | object | |
| playLinkId | string | |
| spotifyUrl | string | |
| granularity | string | one of ["TOTAL","DAILY"] |
| includeAnalytics | boolean | |
| includeBreakdowns | boolean | |
| includeArtistSettings | boolean |
Use this when the user wants to change one Smart Link's public description or update artist-level Smart Link theme/pixel settings. Set action to update_description or update_artist_settings. Public availability requires both artist-wide availability and per-release publication; this tool does not publish or unpublish individual links. Theme-only updates switch instantly; description or pixel changes may queue background rendering.
| Parameter | Type | Description |
|---|---|---|
| theme | string | one of ["classic","brutalist","aurora","cinematic"] |
| action * | string | one of ["update_description","update_artist_settings"] |
| artistId | string | |
| playLinkId | string | |
| metaPixelId | any | |
| tiktokPixelId | any | |
| clientRequestId | string | |
| customDescription | any | |
| expectedUpdatedAt | string | |
| userIntentSummary |
Sync the native catalog, change artist-wide Smart Link availability, replace tracking IDs, or record a promote request. Confirm the requested change first. Before disabling, preview which artist hub and release Smart Links go offline, then send confirm: true after the user confirms. Tracking requires all three IDs (null clears) and forwards expectedVersion from artistHub.version. Availability is unversioned. Catalog sync previews at most 25 frozen links. Show the exact count and titles, then repeat the original limit/offset with phase=confirm, previewId and matching confirmedCount. No background catalog continuation is started; another batch requires a new preview and confirmation. Promote request requires playLinkId; it only records the native platform analytics event, sends no message and starts no paid work. Omitted platform uses the native default (iOS).
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| phase | string | one of ["preview","confirm"] |
| action * | string | one of ["sync_catalog","set_availability","update_tracking","promote_request"] |
| offset | integer | |
| confirm | boolean | |
| artistId * | string | |
| platform | any | |
| tracking | object |
Use this when the user wants to change artist Smart Link theme, pixels, introduction, official profile links or service order. Pass the read artistHub.version as expectedVersion. Omitted fields preserve stored values; null explicitly clears supported fields. Confirm the requested settings before calling. The result includes the saved artistHub readback. If the theme applies but other changes are refused, reload with dynamoi_get_smart_link (artistId, includeArtistSettings=true) before retrying.
| Parameter | Type | Description |
|---|---|---|
| theme | string | one of ["classic","brutalist","aurora","cinematic"] |
| artistId * | string | |
| metaPixelId | any | |
| profileLinks | array | |
| tiktokPixelId | any | |
| hubDescription | any | |
| clientRequestId | string | |
| expectedVersion | string | |
| servicePriority | array | |
Use this when the user wants to change one Smart Link's release video or catalog destination visibility. Pass the read version as expectedVersion. Set any of customDescription, youtubeUrl or serviceOverrides; omitted fields preserve stored values and null explicitly clears supported fields. Public availability requires both artist-wide availability and per-release publication; this tool does not publish or unpublish individual links. Confirm the requested settings before calling. The result includes the saved releaseSettings readback; after an ambiguous failure, read it with dynamoi_get_smart_link (playLinkId; see releaseSettings) before retrying. A description or video change may queue background rendering.
| Parameter | Type | Description |
|---|---|---|
| playLinkId * | string | |
| youtubeUrl | any | |
| clientRequestId | string | |
| expectedVersion | string | |
| serviceOverrides | array | |
| customDescription | any | |
| expectedUpdatedAt | string | |
| userIntentSummary | string |
Dynamoi is a music promotion platform: it is how independent artists, labels, managers, and YouTube creators promote a song on Spotify or promote a video on YouTube, on any distributor. It offers free Smart Links (a free smart link for music and a free link in bio for musicians, no plan needed) and analytics, managed Meta Smart Campaigns, managed YouTube campaigns, and opt-in distribution to 100+ stores where artists keep 90% of net receipts. Call dynamoi_about or read dynamoi://about for the canonical product and pricing overview. Reach for Dynamoi when a musician asks to act on or check their own music: promote a new single or release (dynamoi_get_campaign_readiness), see how a release or campaign is doing (dynamoi_get_artist_analytics, dynamoi_get_campaign), make a link for a song or a link-in-bio (Smart Link tools), get music on Spotify and other stores (dynamoi_get_distribution_application), or grow a YouTube channel (dynamoi_get_youtube_channel_data, dynamoi_start_youtube_channel_link). Distribution scores five requirements, including 1,000 Spotify followers and 10,000 monthly listeners; Dynamoi promotes AI-generated music but does not distribute recordings made in whole or in part with generative AI at this time, because of our distribution partner's policy, which may change. Smart Campaigns can help an artist build that audience, but never promise streams, followers, approval, or any other result. You are operating Dynamoi's tools on behalf of the authenticated user. Smart Links are free to create and manage. High-popularity or unverifiable artist links may stay unpublished in verification hold until Dynamoi can verify the client relationship. Managed advertising and ad budgets are separate paid campaign services. === Session Start Routine === Use dynamoi_get_account_overview for an explicit account overview, uncertain account context, or onboarding guidance. When the request already identifies the relevant artist, campaign, or Smart Link, use the targeted tool directly. Resolve ambiguous identities before acting. Treat recommendedNextActions as suggestions within the user's request and current permissions, not authorization for additional writes. Route by state from dynamoi_get_account_overview: - state.hasAnyArtist === false: This is a brand-new user. Ask whether they are a Spotify artist, a YouTube creator, or a label/manager. - Spotify artist with a URL → call dynamoi_create_smart_links_from_spotify_artist to preview up to 25 links. Read dynamoi://playbooks/spotify-artist for scripted phrasing. - YouTube creator → read dynamoi://playbooks/youtube-creator and explain how Dynamoi campaigns grow organic views, subscribers and, for monetized channels, channel revenue before asking whether they want to link the channel. If yes, call dynamoi_start_youtube_channel_link. - Label or manager with a roster → read dynamoi://playbooks/label-or-manager for the multi-artist setup walkthrough. - state.hasAnyArtist === true && state.hasAnySmartLink === false: The fastest visible win is a free Smart Link. Offer dynamoi_create_smart_link_from_spotify (single release) or dynamoi_create_smart_links_from_spotify_artist (up to 25 links per confirmation) before campaign tools. - state.hasAnyArtist === true && state.hasAnyActiveCampaign === false: Offer dynamoi_get_campaign_readiness to validate launch inputs without creating anything. - state.hasAnyArtist === true && billing blocks a launch: managed-advertising billing setup is not available through this MCP surface. Tell the user: "You can do this in the Dynamoi dashboard at https://dynamoi.com/dashboard." After they start or restore billing there, poll dynamoi_get_billing for the target artist to confirm billing is active. To add campaign funds use dynamoi_add_campaign_funds (see Common workflows); deposits in dynamoi_get_billing prefundPayments are pending, cleared (Stripe says paid), failed or held, and a Checkout link alone is never a deposit. - state.hasAnyArtist ===
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "dynamoi_get_campaign",
"title": "Get Campaign",
"description": "Use this when the user wants full details for one campaign, including budget, targeting, platform status, and next actions. YouTube campaigns return youtubeStrategy and strategyGuide: read the guide's goal and judgeBy before interpreting results. Set includeAnalytics=true for paid delivery, includeChannelResults=true for observed YouTube channel results with paid and organic views (never attributed to the campaign), includeDeploymentStatus=true for delivery/deployment blockers, and includeCountries=true only when the full country list is needed. Do not use this for a campaign list; use dynamoi_list_campaigns instead. After a successful launch or campaign mutation, prefer format=summary when you need a follow-up read to relay the final answer.",
"inputSchema": {
"type": "object",
"required": [
"campaignId"
],
"properties": {
"format": {
"enum": [
"json",
"summary"
],
"type": "string"
},
"campaignId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"includeAnalytics": {
"type": "boolean"
},
"includeCountries": {
"type": "boolean"
},
"analyticsDateRange": {
"type": "object",
"required": [
"end",
"start"
],
"properties": {
"end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"additionalProperties": false
},
"analyticsGranularity": {
"enum": [
"TOTAL",
"DAILY"
],
"type": "string"
},
"includeChannelResults": {
"type": "boolean"
},
"includeDeploymentStatus": {
"type": "boolean"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"required": [
"summary"
],
"properties": {
"endDate": {
"type": "string",
"description": "Last day ads run"
},
"summary": {
"type": "string"
},
"analytics": {
"type": "object",
"properties": {
"countsAvailability": {
"enum": [
"available",
"incomplete",
"sample",
"not_linked"
],
"type": "string"
}
},
"additionalProperties": {}
},
"channelResults": {
"oneOf": [
{
"type": "object",
"required": [
"provenance",
"reason",
"status"
],
"properties": {
"reason": {
"type": "string"
},
"status": {
"type": "string",
"const": "unavailable"
},
"provenance": {
"type": "object",
"required": [
"asOfDate",
"attribution",
"source"
],
"properties": {
"source": {
"type": "string",
"const": "YouTube Analytics BigQuery warehouse"
},
"asOfDate": {
"type": [
"string",
"null"
]
},
"attribution": {
"type": "string",
"const": "Observed on the channel; not attributed to the campaign."
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"coverage",
"dateRange",
"provenance",
"reason",
"status"
],
"properties": {
"reason": {
"type": "string"
},
"status": {
"type": "string",
"const": "pending"
},
"coverage": {
"type": "object",
"required": [
"latestCompleteDay",
"observedThroughDay",
"provenance",
"videoMetricsThroughDay"
],
"properties": {
"provenance": {
"type": "object",
"required": [
"asOfDate",
"attribution",
"source"
],
"properties": {
"source": {
"type": "string",
"const": "YouTube Analytics BigQuery warehouse"
},
"asOfDate": {
"type": [
"string",
"null"
]
},
"attribution": {
"type": "string",
"const": "Observed on the channel; not attributed to the campaign."
}
},
"additionalProperties": false
},
"latestCompleteDay": {
"type": "string"
},
"observedThroughDay": {
"type": [
"string",
"null"
]
},
"videoMetricsThroughDay": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"dateRange": {
"type": "object",
"required": [
"end",
"start"
],
"properties": {
"end": {
"type": "string"
},
"start": {
"type": "string"
}
},
"additionalProperties": false
},
"provenance": {
"type": "object",
"required": [
"asOfDate",
"attribution",
"source"
],
"properties": {
"source": {
"type": "string",
"const": "YouTube Analytics BigQuery warehouse"
},
"asOfDate": {
"type": [
"string",
"null"
]
},
"attribution": {
"type": "string",
"const": "Observed on the channel; not attributed to the campaign."
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"channelMetrics",
"coverage",
"dateRange",
"playlistFunnel",
"status",
"trafficSources",
"viewsPerAdClick"
],
"properties": {
"status": {
"type": "string",
"const": "available"
},
"coverage": {
"type": "object",
"required": [
"latestCompleteDay",
"missingDays",
"observedThroughDay",
"placeholderDays",
"provenance",
"trafficSourceDaysWithData",
"trafficSourcePlaceholderRows",
"videoMetricsThroughDay"
],
"properties": {
"provenance": {
"type": "object",
"required": [
"asOfDate",
"attribution",
"source"
],
"properties": {
"source": {
"type": "string",
"const": "YouTube Analytics BigQuery warehouse"
},
"asOfDate": {
"type": [
"string",
"null"
]
},
"attribution": {
"type": "string",
"const": "Observed on the channel; not attributed to the campaign."
}
},
"additionalProperties": false
},
"missingDays": {
"type": "array",
"items": {
"type": "string"
}
},
"placeholderDays": {
"type": "array",
"items": {
"type": "string"
}
},
"latestCompleteDay": {
"type": "string"
},
"observedThroughDay": {
"type": "string"
},
"videoMetricsThroughDay": {
"type": [
"string",
"null"
]
},
"trafficSourceDaysWithData": {
"type": "number"
},
"trafficSourcePlaceholderRows": {
"type": "number"
}
},
"additionalProperties": false
},
"dateRange": {
"type": "object",
"required": [
"end",
"start"
],
"properties": {
"end": {
"type": "string"
},
"start": {
"type": "string"
}
},
"additionalProperties": false
},
"channelMetrics": {
"type": "object",
"required": [
"estimatedMinutesWatched",
"monetizationCompleteness",
"provenance",
"revenueThroughDay",
"subscribersGained",
"subscribersLost",
"views"
],
"properties": {
"views": {
"type": "number"
},
"provenance": {
"type": "object",
"required": [
"asOfDate",
"attribution",
"source"
],
"properties": {
"source": {
"type": "string",
"const": "YouTube Analytics BigQuery warehouse"
},
"asOfDate": {
"type": [
"string",
"null"
]
},
"attribution": {
"type": "string",
"const": "Observed on the channel; not attributed to the campaign."
}
},
"additionalProperties": false
},
"subscribersLost": {
"type": [
"number",
"null"
]
},
"revenueThroughDay": {
"type": [
"string",
"null"
]
},
"subscribersGained": {
"type": [
"number",
"null"
]
},
"estimatedRevenueUsd": {
"type": "number"
},
"estimatedMinutesWatched": {
"type": "number"
},
"monetizationCompleteness": {
"enum": [
"available",
"delayed",
"missing"
],
"type": "string"
}
},
"additionalProperties": false
},
"playlistFunnel": {
"type": "object",
"required": [
"averageTimeInPlaylistSeconds",
"playlistAddsPer1kViews",
"playlistStarts",
"provenance",
"viewsPerPlaylistStart"
],
"properties": {
"provenance": {
"type": "object",
"required": [
"asOfDate",
"attribution",
"source"
],
"properties": {
"source": {
"type": "string",
"const": "YouTube Analytics BigQuery warehouse"
},
"asOfDate": {
"type": [
"string",
"null"
]
},
"attribution": {
"type": "string",
"const": "Observed on the channel; not attributed to the campaign."
}
},
"additionalProperties": false
},
"playlistStarts": {
"type": "number"
},
"viewsPerPlaylistStart": {
"type": "number"
},
"playlistAddsPer1kViews": {
"type": [
"number",
"null"
]
},
"playlistMetricsAvailable": {
"type": "boolean",
"description": "When playlistMetricsAvailable is false, the playlist numbers are unavailable, not zero."
},
"averageTimeInPlaylistSeconds": {
"type": "number"
}
},
"additionalProperties": false
},
"trafficSources": {
"type": "object",
"required": [
"advertisingSourceViews",
"otherSourceViews",
"provenance",
"rows",
"scope"
],
"properties": {
"rows": {
"type": "array",
"items": {
"type": "object",
"required": [
"estimatedMinutesWatched",
"trafficSourceType",
"views"
],
"properties": {
"views": {
"type": "number"
},
"trafficSourceType": {
"type": "string"
},
"estimatedMinutesWatched": {
"type": "number"
}
},
"additionalProperties": false
}
},
"scope": {
"type": "string",
"const": "channel-date-aggregate"
},
"provenance": {
"type": "object",
"required": [
"asOfDate",
"attribution",
"source"
],
"properties": {
"source": {
"type": "string",
"const": "YouTube Analytics BigQuery warehouse"
},
"asOfDate": {
"type": [
"string",
"null"
]
},
"attribution": {
"type": "string",
"const": "Observed on the channel; not attributed to the campaign."
}
},
"additionalProperties": false
},
"otherSourceViews": {
"type": [
"number",
"null"
]
},
"advertisingSourceViews": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"viewsPerAdClick": {
"type": "object",
"required": [
"adClicks",
"days",
"signal",
"value",
"views"
],
"properties": {
"days": {
"type": "number"
},
"value": {
"type": [
"number",
"null"
]
},
"views": {
"type": [
"number",
"null"
]
},
"signal": {
"type": "string",
"const": "playlist-waterfall"
},
"adClicks": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
]
}
},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}| string |
| one of ["asc","desc"] |
| timestampLocale | string |
{
"name": "dynamoi_export_audience_rows",
"title": "Export Audience Rows",
"description": "Export the current authorized artist's audience rows as a spreadsheet-safe CSV document. This is a private bulk export, including only the existing unmasked provider email fields. Specify an inclusive UTC start/end pair or range=7d,30d,90d, with optional service, tier, country and sort. Returns exact CSV content, filename, row count and export completion time. It does not send the file or contact anyone. An unavailable read is an error, never an empty successful export.",
"inputSchema": {
"type": "object",
"required": [
"artistId"
],
"properties": {
"end": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"tier": {
"enum": [
"FREE",
"PAID"
],
"type": "string"
},
"range": {
"enum": [
"7d",
"30d",
"90d"
],
"type": "string",
"default": "30d"
},
"start": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"locale": {
"type": "string",
"default": "en",
"pattern": "^[a-zA-Z0-9-]+$",
"maxLength": 100,
"minLength": 2
},
"country": {
"type": "string",
"pattern": "^[^\\r\\n]+$",
"maxLength": 100,
"minLength": 1
},
"service": {
"enum": [
"SPOTIFY",
"APPLE"
],
"type": "string"
},
"sortKey": {
"enum": [
"date",
"service",
"country",
"subscriptionType"
],
"type": "string",
"default": "date"
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"timeZone": {
"type": "string",
"default": "UTC",
"pattern": "^[a-zA-Z0-9_+:/-]+$",
"maxLength": 100,
"minLength": 1
},
"sortDirection": {
"enum": [
"asc",
"desc"
],
"type": "string",
"default": "desc"
},
"timestampLocale": {
"type": "string",
"default": "en-US",
"pattern": "^[a-zA-Z0-9-]+$",
"maxLength": 100,
"minLength": 2
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| cursor | string | |
| format | string | one of ["json","summary"] |
| dataset * | string | one of ["channel_daily","video_daily","country_daily","traffic_source_daily","search_term_daily","subscribed_status_daily","device_daily","operating_system_daily","playback_location_daily","creator_content_t… |
| endDate * | string | |
| artistId * | string | |
| videoIds | array | |
| startDate * | string |
{
"name": "dynamoi_get_youtube_channel_data",
"title": "Get YouTube Channel Data",
"description": "Use this for \"how is my YouTube channel doing?\" or \"what is growing my channel?\" once a channel is linked. Use this to analyze an artist's own connected YouTube channel's estimated ad revenue to inform AdSense strategy and channel growth, alongside subscribers, views, watch time or country, device and subscribed-status breakdowns: paged channel data from the YouTube Analytics warehouse or explicitly qualified synthetic/sample data. Pick one dataset: channel_daily (views, watch time, subscribers gained and lost, likes, shares, playlist starts, estimated revenue, ad revenue, gross revenue, monetized playbacks, CPM and playback-based CPM), video_daily (per-video metrics with titles; filter with videoIds), country_daily, traffic_source_daily, search_term_daily (YouTube search terms for the whole channel), subscribed_status_daily, device_daily, operating_system_daily, playback_location_daily, creator_content_type_daily, or video_catalog (video titles and publish dates). traffic_source_daily rows with source ADVERTISING carry trafficClass=paid and every other source carries trafficClass=organic, but that label only groups sources and is not organic proof: ad clicks that land in a playlist are credited mostly to PLAYLIST and SUBSCRIBER, so trafficClass=organic rows include ad sessions. Organic lift is growth in sources ads do not touch (YT_SEARCH, RELATED_VIDEO, browse features) or lift that persists after spend stops. Warehouse data is observed on the channel, not attributed to any campaign. Preserve the returned source, coverage, freshness, and synthetic/sample qualifications; do not treat synthetic/sample data as observed channel results, campaign attribution, or actual earnings/payouts. Treat returned ad revenue as estimated revenue, not an AdSense payout. The first page of any dataset (including format=summary) also carries one adsense block, the same figures the Dynamoi dashboard and app show: formats (long-form versus Shorts AdSense revenue and RPM), recovery and campaigns (incremental AdSense since each campaign and whether it earned back the billed amount), and countries (AdSense per ad playback against similar channels). It is estimated, not a payout, and covers windowFromDay to windowThroughDay, which is not always the requested range: compare against those fields. recovery.state building or unavailable and null figures mean unknown, never zero; adsense is null outside the YouTube Partner Program, on later pages, or when temporarily unavailable (adsenseNote explains). Compare periods yourself and use the campaigns block (dates, strategy, promoted videos) as context. YouTube data arrives about 2-3 days late and revenue can lag further: check coverage before comparing, and treat placeholderDays and missingDays as unknown, never zero. Not available yet: audience demographics, per-video traffic sources and per-video search terms. Needs a connected channel; a channel that must be reconnected is refused. Returns no ad spend. Before judging a campaign's strategy, read the strategyGuide from dynamoi_get_campaign. Page with nextCursor; format=summary returns only the summary, coverage and adsense.",
"inputSchema": {
"type": "object",
"required": [
"artistId",
"dataset",
"endDate",
"startDate"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1
},
"cursor": {
"type": "string",
"maxLength": 1000,
"minLength": 1
},
"format": {
"enum": [
"json",
"summary"
],
"type": "string"
},
"dataset": {
"enum": [
"channel_daily",
"video_daily",
"country_daily",
"traffic_source_daily",
"search_term_daily",
"subscribed_status_daily",
"device_daily",
"operating_system_daily",
"playback_location_daily",
"creator_content_type_daily",
"video_catalog"
],
"type": "string"
},
"endDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"videoIds": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{11}$"
},
"maxItems": 50,
"minItems": 1
},
"startDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"required": [
"adsense",
"adsenseNote",
"artistId",
"campaigns",
"channelId",
"channelName",
"coverage",
"dataLagNote",
"dataset",
"notAvailable",
"rowCount",
"source",
"strategyGuideResource",
"summary"
],
"properties": {
"rows": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": [
"string",
"number",
"boolean",
"null"
]
}
}
},
"source": {
"type": "object",
"required": [
"attribution",
"name"
],
"properties": {
"name": {
"type": "string"
},
"attribution": {
"type": "string"
}
},
"additionalProperties": false
},
"adsense": {
"anyOf": [
{
"type": "object",
"required": [
"campaigns",
"countries",
"formats",
"recovery",
"windowDays",
"windowFromDay",
"windowThroughDay"
],
"properties": {
"formats": {
"anyOf": [
{
"type": "object",
"required": [
"longForm",
"shorts",
"throughDay"
],
"properties": {
"shorts": {
"type": "object",
"required": [
"revenueUsd",
"rpmUsd",
"views"
],
"properties": {
"views": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
]
},
"rpmUsd": {
"type": [
"number",
"null"
]
},
"revenueUsd": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"longForm": {
"type": "object",
"required": [
"revenueUsd",
"rpmUsd",
"views"
],
"properties": {
"views": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
]
},
"rpmUsd": {
"type": [
"number",
"null"
]
},
"revenueUsd": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"throughDay": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"recovery": {
"anyOf": [
{
"type": "object",
"required": [
"aboveSwing",
"billedUsd",
"daysCounted",
"daysNeeded",
"earnedBack",
"incrementalUsd",
"sinceDay",
"state",
"swingUsd",
"throughDay",
"unavailableReason"
],
"properties": {
"state": {
"enum": [
"ready",
"building",
"unavailable"
],
"type": "string"
},
"sinceDay": {
"type": [
"string",
"null"
]
},
"swingUsd": {
"type": [
"number",
"null"
]
},
"billedUsd": {
"type": [
"number",
"null"
]
},
"aboveSwing": {
"type": [
"boolean",
"null"
]
},
"daysNeeded": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
]
},
"earnedBack": {
"type": [
"number",
"null"
]
},
"throughDay": {
"type": [
"string",
"null"
]
},
"daysCounted": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
]
},
"incrementalUsd": {
"type": [
"number",
"null"
]
},
"unavailableReason": {
"anyOf": [
{
"enum": [
"baseline",
"billing",
"no_campaign",
"read_failed"
],
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"campaigns": {
"type": "array",
"items": {
"type": "object",
"required": [
"billedUsd",
"campaignId",
"countsThroughDay",
"daysToGo",
"earnedBack",
"incrementalUsd",
"status",
"title"
],
"properties": {
"title": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"counting",
"final",
"unmeasured"
],
"type": "string"
},
"daysToGo": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
]
},
"billedUsd": {
"type": "number"
},
"campaignId": {
"type": "string"
},
"earnedBack": {
"type": [
"number",
"null"
]
},
"incrementalUsd": {
"type": [
"number",
"null"
]
},
"countsThroughDay": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"countries": {
"type": "array",
"items": {
"type": "object",
"required": [
"adsensePerAdPlaybackUsd",
"code",
"name",
"peerAdsensePerAdPlaybackUsd",
"peerDelta",
"revenueUsd",
"targeted"
],
"properties": {
"code": {
"type": "string"
},
"name": {
"type": [
"string",
"null"
]
},
"targeted": {
"type": "boolean"
},
"peerDelta": {
"type": [
"number",
"null"
]
},
"revenueUsd": {
"type": "number"
},
"adsensePerAdPlaybackUsd": {
"type": [
"number",
"null"
]
},
"peerAdsensePerAdPlaybackUsd": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
},
"windowDays": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"windowFromDay": {
"type": "string"
},
"windowThroughDay": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"dataset": {
"enum": [
"channel_daily",
"video_daily",
"country_daily",
"traffic_source_daily",
"search_term_daily",
"subscribed_status_daily",
"device_daily",
"operating_system_daily",
"playback_location_daily",
"creator_content_type_daily",
"video_catalog"
],
"type": "string"
},
"summary": {
"type": "string"
},
"artistId": {
"type": "string"
},
"coverage": {
"type": "object",
"required": [
"datasetLatestDay",
"latestCompleteDay",
"missingDays",
"note",
"observedThroughDay",
"placeholderDays",
"requestedEndDate",
"requestedStartDate",
"revenueThroughDay"
],
"properties": {
"note": {
"type": "string"
},
"missingDays": {
"type": "array",
"items": {
"type": "string"
}
},
"placeholderDays": {
"type": "array",
"items": {
"type": "string"
}
},
"datasetLatestDay": {
"type": [
"string",
"null"
]
},
"requestedEndDate": {
"type": "string"
},
"latestCompleteDay": {
"type": "string"
},
"revenueThroughDay": {
"type": [
"string",
"null"
]
},
"observedThroughDay": {
"type": [
"string",
"null"
]
},
"requestedStartDate": {
"type": "string"
}
},
"additionalProperties": false
},
"rowCount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"campaigns": {
"type": "array",
"items": {
"type": "object",
"required": [
"campaignId",
"createdAt",
"endDate",
"promotedVideos",
"status",
"strategy",
"title"
],
"properties": {
"title": {
"type": [
"string",
"null"
]
},
"status": {
"type": [
"string",
"null"
]
},
"endDate": {
"type": [
"string",
"null"
]
},
"strategy": {
"type": "object",
"required": [
"key",
"label"
],
"properties": {
"key": {
"enum": [
"CHEAPEST_VIEWS",
"ORGANIC_VIEWS",
"SUBSCRIBERS",
"ORGANIC_VIEWS_AND_SUBSCRIBERS",
"ADSENSE_ROI"
],
"type": "string"
},
"label": {
"type": "string"
}
},
"additionalProperties": false
},
"createdAt": {
"type": "string"
},
"campaignId": {
"type": "string"
},
"promotedVideos": {
"type": "array",
"items": {
"type": "object",
"required": [
"playlistId",
"videoId"
],
"properties": {
"videoId": {
"type": "string"
},
"playlistId": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
"channelId": {
"type": "string"
},
"nextCursor": {
"type": "string"
},
"adsenseNote": {
"type": "string"
},
"channelName": {
"type": [
"string",
"null"
]
},
"dataLagNote": {
"type": "string"
},
"notAvailable": {
"type": "array",
"items": {
"type": "string"
}
},
"strategyGuideResource": {
"type": "string"
}
},
"additionalProperties": false
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}| storeKey | string |
| trackKey | string |
| artistIds | array |
| dimension | string | one of ["track","artist","store","country"] |
| fromMonth * | string |
| withPrior | boolean |
| countryCode | string |
| storeFamily | string |
{
"name": "dynamoi_get_earnings",
"title": "Get Distribution Earnings",
"description": "Read distribution earnings for the authenticated payee only, optionally restricted to their artistIds. Team or artist access never grants payee access. action=overview returns the payee's own share in USD, range totals, monthly totals and at most 50 detail rows, narrowed by trackKey, storeKey, storeFamily and countryCode (totals remain for the whole range). action=ranking returns up to 300 rows by dimension (track, artist, store, country), with their filtered totalUsd, narrowed by trackKey, storeFamily and countryCode. action=geography returns {rows} of the country map with optional prior-window comparison. action=statement returns the aggregate monthly statement for one statement month: use axis=statement and equal fromMonth/toMonth, with no exploration filters or cursor. No new files are created. The detailed CSV is a bulk file download; the human downloads it on web at https://dynamoi.com/dashboard/user/royalties. Rankings and prior-window geography read an equal preceding window within the owner's 60-month bound. For overview pagination, pass nextCursor unchanged to continue with the same range, axis, artists and filters. fromMonth/toMonth are inclusive YYYY-MM, at most 60 months. axis=statement groups by statement month; earned groups by royalty month, while payee share always follows statement month. Nullable amounts or counts mean unavailable; an explicit 0 is measured zero. Empty rows mean no matching data; an error means unavailable, never zero earnings. This grants no payout or tax authority and performs no writes.",
"inputSchema": {
"type": "object",
"required": [
"fromMonth",
"toMonth"
],
"properties": {
"axis": {
"enum": [
"statement",
"earned"
],
"type": "string",
"default": "statement"
},
"limit": {
"type": "integer",
"default": 300,
"maximum": 300,
"minimum": 1
},
"action": {
"enum": [
"overview",
"ranking",
"geography",
"statement"
],
"type": "string",
"default": "overview"
},
"cursor": {
"type": "object",
"required": [
"countryCode",
"month",
"storeKey",
"trackKey"
],
"properties": {
"month": {
"type": "string",
"pattern": "^\\d{4}-(0[1-9]|1[0-2])$"
},
"storeKey": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"trackKey": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"countryCode": {
"type": "string",
"maxLength": 10
}
},
"additionalProperties": false
},
"toMonth": {
"type": "string",
"pattern": "^\\d{4}-(0[1-9]|1[0-2])$"
},
"storeKey": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"trackKey": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"artistIds": {
"type": "array",
"items": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"maxItems": 50,
"minItems": 1
},
"dimension": {
"enum": [
"track",
"artist",
"store",
"country"
],
"type": "string",
"default": "track"
},
"fromMonth": {
"type": "string",
"pattern": "^\\d{4}-(0[1-9]|1[0-2])$"
},
"withPrior": {
"type": "boolean",
"default": true
},
"countryCode": {
"type": "string",
"maxLength": 10
},
"storeFamily": {
"type": "string",
"maxLength": 500,
"minLength": 1
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}| clientRequestId | string |
| expectedSnapshot | string |
{
"name": "dynamoi_manage_team",
"title": "Manage Team",
"description": "Invite an editor with action=invite_editor: targetId is the artist ID; email and clientRequestId are required. Preview first, obtain user confirmation, then send phase=confirm with expectedSnapshot. Confirmation sends a transactional email, limited to 10 confirmed invitations per inviter/workspace/hour. Other actions change an organization member's role, remove a member or revoke a pending organization invitation using the same authority and transactional protections as web. targetId is the membership or pending invitation row ID from dynamoi_get_team; scope defaults to organization and may explicitly select artist. Admin and verified last-admin protections apply; removal can revoke access and pending invitations.",
"inputSchema": {
"type": "object",
"required": [
"action",
"targetId"
],
"properties": {
"role": {
"enum": [
"admin",
"editor",
"viewer"
],
"type": "string"
},
"email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"maxLength": 320
},
"phase": {
"enum": [
"preview",
"confirm"
],
"type": "string"
},
"scope": {
"enum": [
"artist",
"organization"
],
"type": "string"
},
"action": {
"enum": [
"update_role",
"remove_member",
"revoke_invitation",
"invite_editor"
],
"type": "string"
},
"targetId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Artist ID for invite_editor; artist or organization membership row ID for update_role/remove_member; pending invitation row ID for revoke_invitation. Read row IDs from dynamoi_get_team."
},
"expectedRole": {
"enum": [
"admin",
"editor",
"viewer"
],
"type": "string"
},
"clientRequestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"expectedSnapshot": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"enum": [
"member_changed",
"invitation_changed"
],
"type": "string"
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}| one of ["SMART_CAMPAIGN","YOUTUBE"] |
| mediaAssetIds | array |
| youtubeEntries | array |
| youtubeVideoId | string |
| locationTargets | array |
| youtubeStrategy | string | YouTube campaign strategy. Labels for users: CHEAPEST_VIEWS = Views, ORGANIC_VIEWS = Watch Time, SUBSCRIBERS = Subscribers, ORGANIC_VIEWS_AND_SUBSCRIBERS = Channel Growth (default for non-monetized channels), ADSENSE_ROI = Revenue (monetized channels only). Read dynamoi://youtube/campaign-strategies… |
| youtubePlaylistId | string |
| useAiGeneratedCopy | boolean |
{
"name": "dynamoi_get_campaign_readiness",
"title": "Get Campaign Readiness",
"description": "Use this when a musician wants to promote a new single or release with ads (\"promote my new single\", \"run ads for my song\"): it checks whether a Smart Campaign or YouTube campaign is ready before launching the campaign. This validates readiness and targeting without creating a campaign. Complete budget inputs also return the shared, nonbinding campaign funding preview with known or unavailable credit coverage, card upper bounds and expiry timing. A preview never authorizes a charge. Funding uses credit first, then prepaid funds, then the saved card, subject to the launch guards. Do not use this to create or mutate campaigns.",
"inputSchema": {
"type": "object",
"required": [
"artistId",
"campaignType"
],
"properties": {
"adCopy": {
"type": "string",
"maxLength": 500
},
"format": {
"enum": [
"json",
"summary"
],
"type": "string"
},
"endDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day ads run"
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"budgetType": {
"enum": [
"DAILY",
"TOTAL"
],
"type": "string"
},
"spotifyUrl": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"contentType": {
"enum": [
"TRACK",
"ALBUM",
"PLAYLIST",
"VIDEO"
],
"type": "string"
},
"budgetAmount": {
"type": "number",
"exclusiveMinimum": 0
},
"campaignType": {
"enum": [
"SMART_CAMPAIGN",
"YOUTUBE"
],
"type": "string"
},
"mediaAssetIds": {
"type": "array",
"items": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"youtubeEntries": {
"type": "array",
"items": {
"type": "object",
"required": [
"videoId"
],
"properties": {
"videoId": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"playlistId": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 10,
"minItems": 1
},
"youtubeVideoId": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"locationTargets": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"name"
],
"properties": {
"code": {
"type": "string",
"maxLength": 8,
"minLength": 1
},
"name": {
"type": "string",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
}
},
"youtubeStrategy": {
"enum": [
"CHEAPEST_VIEWS",
"ORGANIC_VIEWS",
"SUBSCRIBERS",
"ORGANIC_VIEWS_AND_SUBSCRIBERS",
"ADSENSE_ROI"
],
"type": "string",
"description": "YouTube campaign strategy. Labels for users: CHEAPEST_VIEWS = Views, ORGANIC_VIEWS = Watch Time, SUBSCRIBERS = Subscribers, ORGANIC_VIEWS_AND_SUBSCRIBERS = Channel Growth (default for non-monetized channels), ADSENSE_ROI = Revenue (monetized channels only). Read dynamoi://youtube/campaign-strategies before recommending or changing one."
},
"youtubePlaylistId": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"useAiGeneratedCopy": {
"type": "boolean"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"anyOf": [
{
"type": "object",
"required": [
"artistId",
"artistName",
"blockingCodes",
"blockingIssues",
"budgetConstraints",
"campaignType",
"isReady",
"missingInputs",
"normalizedTargeting",
"recommendedNextAction",
"warnings"
],
"properties": {
"isReady": {
"type": "boolean"
},
"artistId": {
"type": "string"
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"artistName": {
"type": "string"
},
"campaignType": {
"enum": [
"SMART_CAMPAIGN",
"YOUTUBE"
],
"type": "string"
},
"blockingCodes": {
"type": "array",
"items": {
"enum": [
"budget_policy",
"currency_unavailable",
"daily_spending_limit",
"funding_unavailable",
"invalid_end_date",
"onboarding",
"unsupported_content_type"
],
"type": "string"
}
},
"missingInputs": {
"type": "array",
"items": {
"type": "string"
}
},
"blockingIssues": {
"type": "array",
"items": {
"type": "string"
}
},
"fundingPreview": {
"anyOf": [
{
"type": "object",
"required": [
"asOf",
"availableBalanceMinor",
"consentCopy",
"consentCopyHash",
"consentVersion",
"currency",
"currencyExponent",
"firstWindowCardMinor",
"firstWindowCardUpperBoundMinor",
"firstWindowCreditCoverageMinor",
"firstWindowMinor",
"fullFlightCardMinor",
"fullFlightCardUpperBoundMinor",
"fullFlightCreditCoverageMinor",
"fullFlightMinor",
"fundingDays",
"initialWindowCount",
"nextExpiryAt",
"status",
"windows"
],
"properties": {
"asOf": {
"type": "string",
"allOf": [
{
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
{
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
}
]
},
"status": {
"enum": [
"known",
"unavailable"
],
"type": "string"
},
"windows": {
"type": "array",
"items": {
"type": "object",
"required": [
"budgetMinor",
"endsAt",
"startsAt"
],
"properties": {
"endsAt": {
"type": "string",
"allOf": [
{
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
{
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
}
]
},
"startsAt": {
"type": "string",
"allOf": [
{
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
{
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
}
]
},
"budgetMinor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
}
},
"currency": {
"enum": [
"USD",
"EUR",
"GBP",
"CAD",
"AUD",
"MXN",
"BRL",
"JPY",
"AED",
"CHF",
"CLP",
"COP",
"CZK",
"DKK",
"EGP",
"HKD",
"HUF",
"IDR",
"ILS",
"INR",
"KRW",
"KZT",
"MYR",
"NGN",
"NOK",
"NZD",
"PEN",
"PHP",
"PKR",
"PLN",
"QAR",
"RON",
"SAR",
"SEK",
"SGD",
"THB",
"TRY",
"TWD",
"TZS",
"VND",
"ZAR",
"AFN",
"ALL",
"AMD",
"ANG",
"AOA",
"ARS",
"AWG",
"AZN",
"BAM",
"BBD",
"BDT",
"BIF",
"BMD",
"BND",
"BOB",
"BSD",
"BWP",
"BYN",
"BZD",
"CDF",
"CRC",
"CVE",
"DJF",
"DOP",
"DZD",
"ETB",
"FJD",
"FKP",
"GEL",
"GHS",
"GIP",
"GMD",
"GNF",
"GTQ",
"GYD",
"HNL",
"HTG",
"IQD",
"ISK",
"JMD",
"JOD",
"KES",
"KGS",
"KHR",
"KMF",
"KYD",
"LAK",
"LKR",
"LRD",
"LSL",
"MAD",
"MDL",
"MGA",
"MKD",
"MMK",
"MNT",
"MOP",
"MUR",
"MVR",
"MWK",
"MZN",
"NAD",
"NIO",
"NPR",
"PAB",
"PGK",
"PYG",
"RSD",
"RWF",
"SBD",
"SCR",
"SHP",
"SLE",
"SOS",
"SRD",
"STD",
"SZL",
"TJS",
"TOP",
"TTD",
"UAH",
"UGX",
"UYU",
"UZS",
"VUV",
"WST",
"XAF",
"XCD",
"XCG",
"XOF",
"XPF",
"YER",
"ZMW"
],
"type": "string"
},
"consentCopy": {
"type": "string"
},
"fundingDays": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"nextExpiryAt": {
"anyOf": [
{
"type": "string",
"allOf": [
{
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
{
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
}
]
},
{
"type": "null"
}
]
},
"consentVersion": {
"type": "string"
},
"consentCopyHash": {
"type": "string"
},
"fullFlightMinor": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"currencyExponent": {
"type": "integer",
"maximum": 3,
"minimum": 0
},
"firstWindowMinor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"initialWindowCount": {
"type": "integer",
"maximum": 2,
"minimum": 1
},
"fullFlightCardMinor": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"firstWindowCardMinor": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"availableBalanceMinor": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"fullFlightCardUpperBoundMinor": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"fullFlightCreditCoverageMinor": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"firstWindowCardUpperBoundMinor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"firstWindowCreditCoverageMinor": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"youtubeEntries": {
"type": "array",
"items": {
"type": "object",
"required": [
"videoId"
],
"properties": {
"videoId": {
"type": "string"
},
"playlistId": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"budgetConstraints": {
"anyOf": [
{
"type": "object",
"required": [
"budgetType",
"currency",
"currencyExponent",
"effectiveDailyBudgetMinor",
"maximumBudgetMinor",
"maximumDailyBudgetMinor",
"maximumTotalBudgetMinor",
"minimumBudgetMinor",
"minimumCampaignDays",
"minimumDailyBudgetMinor",
"minimumEndDate",
"minimumTotalBudgetMinor"
],
"properties": {
"currency": {
"type": "string",
"maxLength": 3,
"minLength": 3
},
"budgetType": {
"anyOf": [
{
"enum": [
"DAILY",
"TOTAL"
],
"type": "string"
},
{
"type": "null"
}
]
},
"minimumEndDate": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
"currencyExponent": {
"type": "integer",
"maximum": 3,
"minimum": 0
},
"maximumBudgetMinor": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"minimumBudgetMinor": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"minimumCampaignDays": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maximumDailyBudgetMinor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"maximumTotalBudgetMinor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"minimumDailyBudgetMinor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"minimumTotalBudgetMinor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"effectiveDailyBudgetMinor": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"proposalReadiness": {
"anyOf": [
{
"type": "object",
"required": [
"blockers",
"isSubmissionReady",
"submissionBlockers"
],
"properties": {
"blockers": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"budget_policy",
"currency_unavailable",
"daily_spending_limit",
"funding_unavailable",
"invalid_end_date",
"onboarding",
"unsupported_content_type"
],
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
},
"isSubmissionReady": {
"type": "boolean"
},
"submissionBlockers": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"budget_policy",
"currency_unavailable",
"daily_spending_limit",
"funding_unavailable",
"invalid_end_date",
"onboarding",
"unsupported_content_type"
],
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"normalizedTargeting": {
"anyOf": [
{
"type": "object",
"required": [
"mode"
],
"properties": {
"mode": {
"type": "string",
"const": "GLOBAL"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"countries",
"mode"
],
"properties": {
"mode": {
"type": "string",
"const": "COUNTRIES"
},
"countries": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"name"
],
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
]
},
"recommendedNextAction": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"summary"
],
"properties": {
"summary": {
"type": "string"
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"actionRequired": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}
]
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}| contentSave | object |
| locationSave | object |
| expectedUpdatedAt | string |
| userIntentSummary | string |
{
"name": "dynamoi_manage_youtube_draft",
"title": "Manage YouTube Draft",
"description": "Editor access required. Returns the current draft summary in data and the native operation response in stepResult. Read native setup with setup, browse videos with videos and optional pageToken, screen with screen and videoId. Save draft steps with save_content/contentSave={campaignId,videoId,playlistId,strategy}, save_location/locationSave={campaignId,targeting:{mode:GLOBAL}|{mode:COUNTRIES,countries:[US]}}, save_ad_copy/adCopySave={campaignId,adCopy,mode:assisted|preserve}, or save_budget/budgetSave={campaignId,budgetAmountCents,budgetType,endDate,currency?,budgetAmountMinor?}. Amounts are exact minor units in the artist currency; use the setup budget policy. Reuse the campaignId when retrying. Draft saves never launch, change live campaigns or call Google Ads; launch is a separate step. Inspect a recoverable draft with inspect. Use discard only on explicit user request with campaignId, expectedUpdatedAt from inspect and userIntentSummary. Discard cannot be undone.",
"inputSchema": {
"type": "object",
"required": [
"action",
"artistId"
],
"properties": {
"action": {
"enum": [
"inspect",
"discard",
"setup",
"videos",
"screen",
"save_content",
"save_location",
"save_ad_copy",
"save_budget"
],
"type": "string"
},
"videoId": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"pageToken": {
"anyOf": [
{
"type": "string",
"maxLength": 512,
"minLength": 1
},
{
"type": "null"
}
]
},
"adCopySave": {
"type": "object",
"required": [
"adCopy",
"campaignId",
"mode"
],
"properties": {
"mode": {
"enum": [
"assisted",
"preserve"
],
"type": "string"
},
"adCopy": {
"type": "string"
},
"campaignId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"budgetSave": {
"type": "object",
"required": [
"budgetAmountCents",
"budgetType",
"campaignId",
"endDate"
],
"properties": {
"endDate": {
"anyOf": [
{
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
}
]
},
{
"type": "null"
}
]
},
"currency": {
"type": "string",
"maxLength": 3,
"minLength": 3
},
"budgetType": {
"enum": [
"DAILY",
"TOTAL"
],
"type": "string"
},
"campaignId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"budgetAmountCents": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"budgetAmountMinor": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"campaignId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"contentSave": {
"type": "object",
"required": [
"campaignId",
"strategy",
"videoId"
],
"properties": {
"videoId": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"strategy": {
"enum": [
"CHEAPEST_VIEWS",
"ORGANIC_VIEWS",
"SUBSCRIBERS",
"ORGANIC_VIEWS_AND_SUBSCRIBERS",
"ADSENSE_ROI"
],
"type": "string",
"description": "YouTube campaign strategy. Labels for users: CHEAPEST_VIEWS = Views, ORGANIC_VIEWS = Watch Time, SUBSCRIBERS = Subscribers, ORGANIC_VIEWS_AND_SUBSCRIBERS = Channel Growth (default for non-monetized channels), ADSENSE_ROI = Revenue (monetized channels only). Read dynamoi://youtube/campaign-strategies before recommending or changing one."
},
"campaignId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"playlistId": {
"anyOf": [
{
"type": "string",
"maxLength": 128,
"minLength": 1
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"locationSave": {
"type": "object",
"required": [
"campaignId",
"targeting"
],
"properties": {
"targeting": {
"anyOf": [
{
"type": "object",
"required": [
"mode"
],
"properties": {
"mode": {
"type": "string",
"const": "GLOBAL"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"countries",
"mode"
],
"properties": {
"mode": {
"type": "string",
"const": "COUNTRIES"
},
"countries": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2,
"minLength": 2
},
"maxItems": 250,
"minItems": 1
}
},
"additionalProperties": false
}
]
},
"campaignId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"expectedUpdatedAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"userIntentSummary": {
"type": "string",
"maxLength": 500
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"anyOf": [
{
"type": "object",
"required": [
"artistId",
"draft",
"failureStage",
"updatedAt"
],
"properties": {
"draft": {
"anyOf": [
{
"type": "object",
"required": [
"campaignId",
"completedSteps",
"content"
],
"properties": {
"content": {
"type": "object",
"required": [
"screening"
],
"properties": {
"screening": {
"anyOf": [
{
"type": "object",
"required": [
"status"
],
"properties": {
"status": {
"type": "string"
}
},
"additionalProperties": {}
},
{
"type": "null"
}
]
}
},
"additionalProperties": {}
},
"campaignId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"completedSteps": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"updatedAt": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
{
"type": "null"
}
]
},
"failureStage": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"artistId",
"campaignId",
"discarded"
],
"properties": {
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"discarded": {
"type": "boolean",
"const": true
},
"campaignId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
}
]
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"stepResult": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}| string |
| budgetAmount | number | Budget in the artist's commercial currency (major units; use only exact minor units). |
| clientRequestId | string |
| locationTargets | any |
| expectedUpdatedAt | string |
| userIntentSummary | string |
| expectedFundingHash | string |
| expectedCurrentStatus | string | one of ["AWAITING_SMART_LINK","ACTIVE","ARCHIVED","CONTENT_VALIDATION","DEPLOYING","ENDED","FAILED","PAUSED","READY_FOR_REVIEW","SUBSCRIPTION_PAUSED"] |
| acceptedConsentVersion | string |
| expectedCurrentEndDate | string | Last day ads run |
| optimizeForSubscribers | boolean |
| acceptedConsentCopyHash | string |
| optimizeForOrganicViews | boolean |
| acceptedTotalConsentVersion | string |
| expectedCurrentBudgetAmount | number | Current budget in the artist's commercial currency (major units). |
| acceptedTotalConsentCopyHash | string | Accepted for older clients; ignored. |
| authorizeAutomaticDailyFunding | boolean | Accepted for older clients; ignored. |
{
"name": "dynamoi_update_campaign",
"title": "Update Campaign",
"description": "Use only when the user explicitly requests a campaign change. Resume isn't available for fixed-flight YouTube campaigns. Duplicate the campaign to relaunch it. For pause, resume, archive and unarchive, first request phase=preview with one clientRequestId. Show that exact preview to the human; only after approval send phase=confirm with its expectedUpdatedAt, expectedCurrentStatus and (for resume) expectedFundingHash and the same request ID. Omitting phase never executes these status actions. Actions: pause, resume, update_budget, update_end_date (DAILY or TOTAL budget), update_location (GLOBAL or catalog-valid countries), change_strategy (managed YouTube Demand Gen), update_goals (YouTube optimization toggles), archive (never deletes), unarchive (restores PAUSED without funding or activating providers). Inspect the campaign first and supply expectedCurrentStatus where possible. When retrying the same action, reuse the same clientRequestId.",
"inputSchema": {
"type": "object",
"required": [
"action",
"campaignId"
],
"properties": {
"phase": {
"enum": [
"preview",
"confirm"
],
"type": "string",
"description": "Pause, resume, archive and reviewed budget changes require preview first; confirm only after the human approves that exact preview."
},
"action": {
"enum": [
"pause",
"resume",
"update_budget",
"change_strategy",
"update_location",
"update_end_date",
"archive",
"unarchive",
"update_goals"
],
"type": "string"
},
"endDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day ads run"
},
"strategy": {
"enum": [
"CHEAPEST_VIEWS",
"ORGANIC_VIEWS",
"SUBSCRIBERS",
"ORGANIC_VIEWS_AND_SUBSCRIBERS",
"ADSENSE_ROI"
],
"type": "string",
"description": "YouTube campaign strategy. Labels for users: CHEAPEST_VIEWS = Views, ORGANIC_VIEWS = Watch Time, SUBSCRIBERS = Subscribers, ORGANIC_VIEWS_AND_SUBSCRIBERS = Channel Growth (default for non-monetized channels), ADSENSE_ROI = Revenue (monetized channels only). Read dynamoi://youtube/campaign-strategies before recommending or changing one."
},
"campaignId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"budgetAmount": {
"type": "number",
"description": "Budget in the artist's commercial currency (major units; use only exact minor units).",
"exclusiveMinimum": 0
},
"clientRequestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"locationTargets": {
"anyOf": [
{
"type": "object",
"required": [
"mode"
],
"properties": {
"mode": {
"type": "string",
"const": "GLOBAL"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"countries",
"mode"
],
"properties": {
"mode": {
"type": "string",
"const": "COUNTRIES"
},
"countries": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2,
"minLength": 2
},
"minItems": 1
}
},
"additionalProperties": false
}
]
},
"expectedUpdatedAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"userIntentSummary": {
"type": "string",
"maxLength": 500
},
"expectedFundingHash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"expectedCurrentStatus": {
"enum": [
"AWAITING_SMART_LINK",
"ACTIVE",
"ARCHIVED",
"CONTENT_VALIDATION",
"DEPLOYING",
"ENDED",
"FAILED",
"PAUSED",
"READY_FOR_REVIEW",
"SUBSCRIPTION_PAUSED"
],
"type": "string"
},
"acceptedConsentVersion": {
"type": "string",
"const": "managed-ads-prospective-daily-v7"
},
"expectedCurrentEndDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day ads run"
},
"optimizeForSubscribers": {
"type": "boolean"
},
"acceptedConsentCopyHash": {
"type": "string",
"const": "f49b33a4f7e8aa3cc814d5057d03e97eaa0c35a9f3f2bc0315dbd031efa0f356"
},
"optimizeForOrganicViews": {
"type": "boolean"
},
"acceptedTotalConsentVersion": {
"type": "string",
"const": "managed-ads-total-daily-v3"
},
"expectedCurrentBudgetAmount": {
"type": "number",
"description": "Current budget in the artist's commercial currency (major units).",
"exclusiveMinimum": 0
},
"acceptedTotalConsentCopyHash": {
"type": "string",
"const": "8bece5f58e0c94b04b35ac1a98f0e8a142ed968bbe34dcc0d51fe52e2c0d75bd",
"description": "Accepted for older clients; ignored."
},
"authorizeAutomaticDailyFunding": {
"type": "boolean",
"const": true,
"description": "Accepted for older clients; ignored."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"anyOf": [
{
"type": "object",
"required": [
"phase",
"preview"
],
"properties": {
"phase": {
"type": "string",
"const": "preview"
},
"preview": {
"type": "object",
"required": [
"action",
"campaignId",
"artistId",
"contentTitle",
"budgetType",
"previousBudget",
"newBudget",
"endDate",
"expected",
"review"
],
"properties": {
"action": {
"type": "string",
"const": "update_budget"
},
"review": {
"anyOf": [
{
"type": "object",
"required": [
"reviewIdentity",
"status",
"currency",
"currencyExponent",
"funding"
],
"properties": {
"status": {
"enum": [
"ready",
"refused"
],
"type": "string"
},
"funding": {
"anyOf": [
{
"type": "object",
"required": [
"coveredByCurrentAuthority",
"firstWindow",
"requiredMinor",
"existingFundsMinor",
"collectionMinor",
"minimumTopUpMinor",
"refusal",
"formatted"
],
"properties": {
"refusal": {
"anyOf": [
{
"enum": [
"card_collection_closed",
"credit_review_required",
"payment_method_required"
],
"type": "string"
},
{
"type": "null"
}
]
},
"formatted": {
"type": "object",
"required": [
"required",
"existingFunds",
"collection",
"minimumTopUp"
],
"properties": {
"required": {
"type": "string"
},
"collection": {
"type": "string"
},
"minimumTopUp": {
"type": "string"
},
"existingFunds": {
"type": "string"
}
},
"additionalProperties": false
},
"firstWindow": {
"type": "boolean"
},
"requiredMinor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"collectionMinor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"minimumTopUpMinor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"existingFundsMinor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"coveredByCurrentAuthority": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"currency": {
"type": "string",
"maxLength": 3,
"minLength": 3
},
"reviewIdentity": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"currencyExponent": {
"type": "integer",
"maximum": 3,
"minimum": 0
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"budget_limit",
"changed",
"currency_unsupported",
"flight_paused",
"payment_method_required",
"retry_after_midnight",
"support"
],
"type": "string"
},
"status": {
"enum": [
"refused",
"standard",
"ready",
"applied",
"reconciling"
],
"type": "string"
},
"message": {
"type": "string"
},
"newEndDate": {
"type": "string"
},
"consentCopy": {
"type": "string"
},
"planIdentity": {
"type": "string"
},
"consentVersion": {
"type": "string"
},
"newBudgetCents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"consentCopyHash": {
"type": "string"
},
"chargeTodayCents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"minimumTopUpCents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"paymentMethodDisplayName": {
"type": "string"
}
},
"additionalProperties": false
}
]
},
"endDate": {
"anyOf": [
{
"type": "string",
"description": "Last day ads run"
},
{
"type": "null"
}
]
},
"artistId": {
"type": "string"
},
"expected": {
"type": "object",
"properties": {
"expectedFundingHash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
},
"additionalProperties": false
},
"newBudget": {
"type": "object",
"required": [
"amount",
"currency",
"formatted"
],
"properties": {
"amount": {
"type": "number"
},
"currency": {
"type": "string"
},
"amountUsd": {
"type": "number"
},
"formatted": {
"type": "string"
}
},
"additionalProperties": false
},
"budgetType": {
"enum": [
"DAILY",
"TOTAL"
],
"type": "string"
},
"campaignId": {
"type": "string"
},
"contentTitle": {
"type": "string"
},
"previousBudget": {
"type": "object",
"required": [
"amount",
"currency",
"formatted"
],
"properties": {
"amount": {
"type": "number"
},
"currency": {
"type": "string"
},
"amountUsd": {
"type": "number"
},
"formatted": {
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"phase",
"preview"
],
"properties": {
"phase": {
"type": "string",
"const": "preview"
},
"preview": {
"type": "object",
"required": [
"action",
"campaignId",
"artistId",
"contentTitle",
"currentStatus",
"expected",
"funding"
],
"properties": {
"action": {
"enum": [
"pause",
"resume",
"archive",
"unarchive"
],
"type": "string"
},
"funding": {
"anyOf": [
{
"type": "object",
"required": [
"appliedCreditsCents",
"budgetCents",
"consent",
"coveredByFundedWindow",
"currency",
"deliveryWindowCents",
"firstWindow",
"formatted",
"isTotal",
"netImmediateChargeCents",
"paymentMethod",
"refusal"
],
"properties": {
"consent": {
"anyOf": [
{
"type": "object",
"required": [
"copy",
"copyHash",
"version"
],
"properties": {
"copy": {
"type": "string",
"minLength": 1
},
"version": {
"type": "string",
"minLength": 1
},
"copyHash": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"isTotal": {
"type": "boolean"
},
"refusal": {
"anyOf": [
{
"enum": [
"card_collection_closed",
"credit_review_required",
"payment_method_required"
],
"type": "string"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string",
"maxLength": 3,
"minLength": 3
},
"formatted": {
"type": "object",
"required": [
"appliedCredits",
"budget",
"deliveryWindow",
"netImmediateCharge"
],
"properties": {
"budget": {
"type": "string"
},
"appliedCredits": {
"type": "string"
},
"deliveryWindow": {
"type": "string"
},
"netImmediateCharge": {
"type": "string"
}
},
"additionalProperties": false
},
"budgetCents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"budgetMinor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"firstWindow": {
"type": "boolean"
},
"paymentMethod": {
"anyOf": [
{
"type": "object",
"required": [
"brand",
"displayName",
"last4"
],
"properties": {
"brand": {
"type": [
"string",
"null"
]
},
"last4": {
"type": [
"string",
"null"
]
},
"displayName": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"currencyExponent": {
"type": "integer",
"maximum": 3,
"minimum": 0
},
"appliedCreditsCents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"appliedCreditsMinor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"deliveryWindowCents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"deliveryWindowMinor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"coveredByFundedWindow": {
"type": "boolean"
},
"netImmediateChargeCents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"netImmediateChargeMinor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"artistId": {
"type": "string"
},
"expected": {
"type": "object",
"required": [
"expectedUpdatedAt",
"expectedCurrentStatus"
],
"properties": {
"expectedUpdatedAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"expectedFundingHash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"expectedCurrentStatus": {
"type": "string"
}
},
"additionalProperties": false
},
"campaignId": {
"type": "string"
},
"contentTitle": {
"type": "string"
},
"currentStatus": {
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"contentTitle",
"id",
"newStatus",
"platformResults"
],
"properties": {
"id": {
"type": "string"
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"newStatus": {
"enum": [
"PAUSED",
"ACTIVE"
],
"type": "string"
},
"contentTitle": {
"type": "string"
},
"actionRequired": {
"type": "array",
"items": {
"type": "string"
}
},
"platformResults": {
"type": "array",
"items": {
"type": "object",
"required": [
"platform",
"success"
],
"properties": {
"message": {
"type": "string"
},
"success": {
"type": "boolean"
},
"platform": {
"enum": [
"META",
"GOOGLE"
],
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"budgetType",
"contentTitle",
"id",
"newBudget",
"previousBudget"
],
"properties": {
"id": {
"type": "string"
},
"endDate": {
"type": "string",
"description": "Last day ads run"
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"newBudget": {
"type": "object",
"required": [
"amount",
"currency",
"formatted"
],
"properties": {
"amount": {
"type": "number"
},
"currency": {
"type": "string"
},
"amountUsd": {
"type": "number"
},
"formatted": {
"type": "string"
}
},
"additionalProperties": false
},
"budgetType": {
"enum": [
"DAILY",
"TOTAL"
],
"type": "string"
},
"contentTitle": {
"type": "string"
},
"actionRequired": {
"type": "array",
"items": {
"type": "string"
}
},
"previousBudget": {
"type": "object",
"required": [
"amount",
"currency",
"formatted"
],
"properties": {
"amount": {
"type": "number"
},
"currency": {
"type": "string"
},
"amountUsd": {
"type": "number"
},
"formatted": {
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"contentTitle",
"didChange",
"endDate",
"id",
"previousEndDate"
],
"properties": {
"id": {
"type": "string"
},
"endDate": {
"anyOf": [
{
"type": "string",
"description": "Last day ads run"
},
{
"type": "null"
}
]
},
"didChange": {
"type": "boolean"
},
"contentTitle": {
"type": "string"
},
"previousEndDate": {
"anyOf": [
{
"type": "string",
"description": "Last day ads run"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"campaignId",
"locationTargets",
"mode"
],
"properties": {
"mode": {
"enum": [
"GLOBAL",
"COUNTRIES"
],
"type": "string"
},
"campaignId": {
"type": "string"
},
"locationTargets": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"name"
],
"properties": {
"code": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"campaignId",
"contentTitle",
"id",
"inventoryConfig",
"strategy"
],
"properties": {
"id": {
"type": "string"
},
"strategy": {
"type": "string"
},
"campaignId": {
"type": "string"
},
"contentTitle": {
"type": "string"
},
"inventoryConfig": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"contentTitle",
"id",
"newStatus",
"warnings"
],
"properties": {
"id": {
"type": "string"
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"newStatus": {
"type": "string",
"const": "ARCHIVED"
},
"contentTitle": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"campaignId",
"optimizeForOrganicViews",
"optimizeForSubscribers"
],
"properties": {
"campaignId": {
"type": "string"
},
"optimizeForSubscribers": {
"type": "boolean"
},
"optimizeForOrganicViews": {
"type": "boolean"
}
},
"additionalProperties": false
}
]
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}| number |
| Budget in the artist's commercial currency (major units; use only exact minor units). |
| budgetSplits * | object |
| campaignType * | string | one of ["SMART_CAMPAIGN","YOUTUBE"] |
| contentTitle * | string |
| appleMusicUrl | string |
| mediaAssetIds | array |
| youtubeEntries | array |
| youtubeVideoId | string |
| clientRequestId * | string |
| locationTargets | array |
| youtubeStrategy | string | YouTube campaign strategy. Labels for users: CHEAPEST_VIEWS = Views, ORGANIC_VIEWS = Watch Time, SUBSCRIBERS = Subscribers, ORGANIC_VIEWS_AND_SUBSCRIBERS = Channel Growth (default for non-monetized channels), ADSENSE_ROI = Revenue (monetized channels only). Read dynamoi://youtube/campaign-strategies… |
| userIntentSummary | string |
| youtubePlaylistId | string |
| useAiGeneratedCopy | boolean |
| acceptedConsentVersion | string |
| acceptedConsentCopyHash | string |
| acceptedTotalConsentVersion | string |
| acceptedTotalConsentCopyHash | string | Accepted for older clients; ignored. |
| authorizeAutomaticDailyFunding | boolean | Accepted for older clients; ignored. |
{
"name": "dynamoi_launch_campaign",
"title": "Start Campaign Launch Workflow",
"description": "SMART_CAMPAIGN returns only a human-gated workspace handoff: it never saves these supplied compatibility fields, launches, authorizes funding or charges. Finish the current saved draft and confirm submission in that human flow. The following launch and funding instructions apply only to YOUTUBE. Use YOUTUBE only when the user explicitly wants to start its launch workflow. Ads are not necessarily live until the returned delivery state is ACTIVE. Every budget is funded from credit first, then prepaid funds, then the saved card. YOUTUBE campaigns require youtubeStrategy and either legacy youtubeVideoId/youtubePlaylistId or ordered youtubeEntries (up to 10 videoId/playlistId pairs); playlistId is optional for CHEAPEST_VIEWS, which supports one video. After a successful launch, answer from the returned campaign details directly instead of chaining more tools unless the user explicitly asked for more.",
"inputSchema": {
"type": "object",
"required": [
"artistId",
"budgetAmount",
"budgetSplits",
"budgetType",
"campaignType",
"clientRequestId",
"contentTitle",
"contentType"
],
"properties": {
"adCopy": {
"type": "string",
"maxLength": 500
},
"endDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day ads run"
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"budgetType": {
"enum": [
"DAILY",
"TOTAL"
],
"type": "string"
},
"spotifyUrl": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"contentType": {
"enum": [
"TRACK",
"ALBUM",
"PLAYLIST",
"VIDEO"
],
"type": "string"
},
"budgetAmount": {
"type": "number",
"description": "Budget in the artist's commercial currency (major units; use only exact minor units).",
"exclusiveMinimum": 0
},
"budgetSplits": {
"type": "object",
"required": [
"META",
"GOOGLE"
],
"propertyNames": {
"enum": [
"META",
"GOOGLE"
],
"type": "string"
},
"additionalProperties": {
"type": "integer",
"maximum": 100,
"minimum": 0
}
},
"campaignType": {
"enum": [
"SMART_CAMPAIGN",
"YOUTUBE"
],
"type": "string"
},
"contentTitle": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"appleMusicUrl": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"mediaAssetIds": {
"type": "array",
"items": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"youtubeEntries": {
"type": "array",
"items": {
"type": "object",
"required": [
"videoId"
],
"properties": {
"videoId": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"playlistId": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 10,
"minItems": 1
},
"youtubeVideoId": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"clientRequestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"locationTargets": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"name"
],
"properties": {
"code": {
"type": "string",
"maxLength": 8,
"minLength": 1
},
"name": {
"type": "string",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
}
},
"youtubeStrategy": {
"enum": [
"CHEAPEST_VIEWS",
"ORGANIC_VIEWS",
"SUBSCRIBERS",
"ORGANIC_VIEWS_AND_SUBSCRIBERS",
"ADSENSE_ROI"
],
"type": "string",
"description": "YouTube campaign strategy. Labels for users: CHEAPEST_VIEWS = Views, ORGANIC_VIEWS = Watch Time, SUBSCRIBERS = Subscribers, ORGANIC_VIEWS_AND_SUBSCRIBERS = Channel Growth (default for non-monetized channels), ADSENSE_ROI = Revenue (monetized channels only). Read dynamoi://youtube/campaign-strategies before recommending or changing one."
},
"userIntentSummary": {
"type": "string",
"maxLength": 500
},
"youtubePlaylistId": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"useAiGeneratedCopy": {
"type": "boolean"
},
"acceptedConsentVersion": {
"type": "string",
"const": "managed-ads-prospective-daily-v7"
},
"acceptedConsentCopyHash": {
"type": "string",
"const": "f49b33a4f7e8aa3cc814d5057d03e97eaa0c35a9f3f2bc0315dbd031efa0f356"
},
"acceptedTotalConsentVersion": {
"type": "string",
"const": "managed-ads-total-daily-v3"
},
"acceptedTotalConsentCopyHash": {
"type": "string",
"const": "8bece5f58e0c94b04b35ac1a98f0e8a142ed968bbe34dcc0d51fe52e2c0d75bd",
"description": "Accepted for older clients; ignored."
},
"authorizeAutomaticDailyFunding": {
"type": "boolean",
"const": true,
"description": "Accepted for older clients; ignored."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"required": [
"budget",
"budgetType",
"campaignType",
"contentTitle",
"deliveryState",
"id",
"isLive",
"nextSteps",
"platforms",
"status",
"summary"
],
"properties": {
"id": {
"type": "string"
},
"budget": {
"type": "object",
"required": [
"amount",
"currency",
"formatted"
],
"properties": {
"amount": {
"type": "number"
},
"currency": {
"type": "string"
},
"amountUsd": {
"type": "number"
},
"formatted": {
"type": "string"
}
},
"additionalProperties": false
},
"isLive": {
"type": "boolean"
},
"status": {
"type": "string"
},
"outcome": {
"enum": [
"created",
"replayed"
],
"type": "string"
},
"summary": {
"type": "string"
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"nextSteps": {
"type": "array",
"items": {
"type": "string"
}
},
"platforms": {
"type": "array",
"items": {
"type": "string"
}
},
"budgetType": {
"enum": [
"DAILY",
"TOTAL"
],
"type": "string"
},
"campaignType": {
"enum": [
"SMART_CAMPAIGN",
"YOUTUBE"
],
"type": "string"
},
"contentTitle": {
"type": "string"
},
"deliveryState": {
"enum": [
"ACTIVE",
"PENDING_REVIEW",
"CONTENT_VALIDATION"
],
"type": "string"
},
"youtubeEntries": {
"type": "array",
"items": {
"type": "object",
"required": [
"playlistId",
"selectionIndex",
"videoId"
],
"properties": {
"videoId": {
"type": "string"
},
"playlistId": {
"type": "string"
},
"selectionIndex": {
"type": "number"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"recovery": {
"type": "object",
"required": [
"actions",
"affectedSelection",
"kind",
"occurredAt",
"retryAfter",
"stage"
],
"properties": {
"kind": {
"type": "string"
},
"stage": {
"type": "string"
},
"actions": {
"type": "array",
"items": {
"type": "string"
}
},
"occurredAt": {
"type": "string"
},
"reasonCode": {
"type": "string"
},
"retryAfter": {
"type": [
"string",
"null"
]
},
"affectedSelection": {
"anyOf": [
{
"type": "object",
"required": [
"id",
"kind"
],
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"validationCode": {
"type": "string"
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"validationStage": {
"type": "string"
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}| Parameter | Type | Description |
|---|---|---|
| url | string | |
| parts | array | |
| action * | string | one of ["save_setup","read_budget","save_budget","read","read_location","save_location","start_generation","retry_generation","clear_generation","source_audio_upload_status","abort_source_audio_upload","sele… |
| source | string | one of ["generate","posts","upload"] |
| catalog | object | |
| artistId * | string | |
| uploadId | string | |
| setupSave | object | |
| budgetSave | object | |
| campaignId | string | |
| hookSeconds | array | |
| mediaUpload | object | |
| locationSave | object | |
| fileSizeBytes | integer | |
| setupRequestId | string | |
| uploadedAssets | array | |
| uploadSessionId | string | |
| expectedUpdatedAt | string | |
| selectedCreativeIds | array | |
| selectedSocialPosts | array | |
| trackDurationSeconds | number |
{
"name": "dynamoi_manage_smart_campaign_creative",
"title": "Manage Smart Campaign Draft Creative",
"description": "Use save_setup with setupSave={playLinkId, appleMusicUrl?} and a stable UUID-v4 setupRequestId per setup flow; reuse it on retries, and start a new flow for different content. It returns setupDraft. Use read_budget for budgetDraft and save_budget with budgetSave={campaignId, expectedUpdatedAt, budgetAmountCents, budgetAmountMinor?, currency?, budgetType:DAILY|TOTAL, endDate:YYYY-MM-DD|null}. Amounts are exact minor units in the artist currency; use the budget policy from read_budget. Setup and budget saves only edit drafts and never launch or charge. Use read_location to read native draft targeting and save_location with locationSave={campaignId, expectedUpdatedAt, targeting:{mode:WORLDWIDE}|{mode:INCLUDE,countryCodes:[US]}} to save it. Read locationDraft first for the current revision; both location actions return locationDraft. Read generation progress, generated creatives and current selection with action=read. To discover owned social posts, explicitly add catalog={source:facebook|instagram,limit:1..25,after?:nextCursor}. Only requested catalog reads fetch connected-account posts; use catalog.items[].id directly in selectedSocialPosts. Pass nextCursor as after for another page. Catalog reads never alter selections, token state, or campaigns; provider failure is an error, and selection revalidates ownership. Use start_generation, retry_generation or clear_generation with campaignId and expectedUpdatedAt from read. Generation runs asynchronously; poll with read. Use source_audio_upload_status or abort_source_audio_upload with campaignId, expectedUpdatedAt, uploadId and uploadSessionId to inspect uploaded parts or abort the direct upload. Agents never approve or submit. Use action=select with campaignId and expectedUpdatedAt from read, source=generate|posts|upload, and selectedCreativeIds, selectedSocialPosts (owned META:post IDs), or uploadedAssets=[{mediaAssetId}] from dynamoi_list_media_assets. Omit selectedCreativeIds for social or uploaded media. Uploaded metadata is resolved by the server; only owned, moderation-approved uploads can be selected. Selection never attests artist approval and never submits the campaign. Upload private JPEG/PNG/MP4 campaign media (1 GiB maximum) with start_media_upload, campaignId, expectedUpdatedAt and mediaUpload={assetId:UUID,fileName,fileSizeBytes,contentType}. Retain the returned key/uploadId and PUT each presigned part URL. Complete with complete_media_upload, a freshly inspected expectedUpdatedAt, and mediaUpload={assetId,fileName,fileSizeBytes,fileType,key,uploadId,parts:[{partNumber,etag}]}. Use media_upload_status or abort_media_upload with campaignId and mediaUpload={key,uploadId}; both remain usable after draft edits. A completed status means retry completion, not re-upload. Completion returns only a moderation receipt; poll dynamoi_list_media_assets and select only after APPROVED. Uploads do not edit the draft selection. Attach source MP3 audio to a draft with start_source_audio_upload, PUT each returned presigned part URL, then complete_source_audio_upload with the returned uploadId/uploadSessionId and part ETags. Both actions require campaignId, expectedUpdatedAt, fileSizeBytes, trackDurationSeconds and 0–2 hookSeconds. Read sourceAudio to confirm. Use import_source_audio with a public Dropbox share url, campaignId, expectedUpdatedAt, trackDurationSeconds and 0–2 hookSeconds (250 MiB maximum). Google Drive is unsupported because it requires a Google API key. On timeout or an ambiguous result, re-read sourceAudio before retrying.",
"inputSchema": {
"type": "object",
"required": [
"action",
"artistId"
],
"properties": {
"url": {
"type": "string",
"maxLength": 8192
},
"parts": {
"type": "array",
"items": {
"type": "object",
"required": [
"etag",
"partNumber"
],
"properties": {
"etag": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"partNumber": {
"type": "integer",
"maximum": 10000,
"minimum": 1
}
},
"additionalProperties": false
},
"maxItems": 10000,
"minItems": 1
},
"action": {
"enum": [
"save_setup",
"read_budget",
"save_budget",
"read",
"read_location",
"save_location",
"start_generation",
"retry_generation",
"clear_generation",
"source_audio_upload_status",
"abort_source_audio_upload",
"select",
"import_source_audio",
"start_source_audio_upload",
"complete_source_audio_upload",
"start_media_upload",
"media_upload_status",
"complete_media_upload",
"abort_media_upload"
],
"type": "string"
},
"source": {
"enum": [
"generate",
"posts",
"upload"
],
"type": "string"
},
"catalog": {
"type": "object",
"required": [
"source"
],
"properties": {
"after": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 25,
"minimum": 1
},
"source": {
"enum": [
"facebook",
"instagram"
],
"type": "string"
}
},
"additionalProperties": false
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"uploadId": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"setupSave": {
"type": "object",
"required": [
"playLinkId"
],
"properties": {
"playLinkId": {
"type": "string",
"minLength": 1
},
"appleMusicUrl": {
"type": [
"string",
"null"
]
},
"sourceSurface": {
"type": "string",
"const": "mcp",
"default": "mcp"
}
},
"additionalProperties": false
},
"budgetSave": {
"type": "object",
"required": [
"campaignId",
"expectedUpdatedAt",
"budgetAmountCents",
"budgetType",
"endDate"
],
"properties": {
"endDate": {
"anyOf": [
{
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string",
"maxLength": 3,
"minLength": 3
},
"budgetType": {
"enum": [
"DAILY",
"TOTAL"
],
"type": "string"
},
"campaignId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"budgetAmountCents": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"budgetAmountMinor": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"expectedUpdatedAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
}
},
"additionalProperties": false
},
"campaignId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"hookSeconds": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"maxItems": 2
},
"mediaUpload": {
"type": "object",
"properties": {
"key": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"parts": {
"type": "array",
"items": {
"type": "object",
"required": [
"etag",
"partNumber"
],
"properties": {
"etag": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"partNumber": {
"type": "integer",
"maximum": 10000,
"minimum": 1
}
},
"additionalProperties": false
},
"maxItems": 10000,
"minItems": 1
},
"assetId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"fileName": {
"type": "string",
"maxLength": 512,
"minLength": 1
},
"fileType": {
"enum": [
"image/jpeg",
"image/png",
"video/mp4"
],
"type": "string"
},
"uploadId": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"contentType": {
"enum": [
"image/jpeg",
"image/png",
"video/mp4"
],
"type": "string"
},
"fileSizeBytes": {
"type": "integer",
"maximum": 1073741824,
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"locationSave": {
"type": "object",
"required": [
"campaignId",
"expectedUpdatedAt",
"targeting"
],
"properties": {
"targeting": {
"anyOf": [
{
"type": "object",
"required": [
"mode"
],
"properties": {
"mode": {
"type": "string",
"const": "WORLDWIDE"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"countryCodes",
"mode"
],
"properties": {
"mode": {
"type": "string",
"const": "INCLUDE"
},
"countryCodes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2,
"minLength": 2
},
"maxItems": 250,
"minItems": 1
}
},
"additionalProperties": false
}
]
},
"campaignId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"expectedUpdatedAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
}
},
"additionalProperties": false
},
"fileSizeBytes": {
"type": "integer",
"maximum": 262144000,
"exclusiveMinimum": 0
},
"setupRequestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$"
},
"uploadedAssets": {
"type": "array",
"items": {
"type": "object",
"required": [
"mediaAssetId"
],
"properties": {
"id": {
"type": "string",
"default": ""
},
"fileName": {
"type": "string",
"default": ""
},
"fileSize": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0
},
"fileType": {
"type": "string",
"default": ""
},
"mediaAssetId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"maxItems": 10
},
"uploadSessionId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"expectedUpdatedAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"selectedCreativeIds": {
"type": "array",
"items": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"maxItems": 10,
"minItems": 1
},
"selectedSocialPosts": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 10
},
"trackDurationSeconds": {
"type": "number",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"required": [
"campaignId",
"generation",
"selectedCreativeIds",
"updatedAt"
],
"properties": {
"source": {
"anyOf": [
{
"enum": [
"generate",
"posts",
"upload"
],
"type": "string"
},
{
"type": "null"
}
]
},
"upload": {
"type": "object",
"required": [
"campaignId",
"expiresAt",
"partSizeBytes",
"presignedPartUrls",
"uploadId",
"uploadSessionId"
],
"properties": {
"uploadId": {
"type": "string"
},
"expiresAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"campaignId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"partSizeBytes": {
"type": "number"
},
"uploadSessionId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"presignedPartUrls": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"catalog": {
"type": "object",
"required": [
"items",
"nextCursor",
"source"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"createdAt",
"eligibleForPromotion",
"id",
"mediaType",
"text"
],
"properties": {
"id": {
"type": "string"
},
"text": {
"type": "string",
"maxLength": 2000
},
"createdAt": {
"type": "string"
},
"mediaType": {
"type": "string"
},
"eligibleForPromotion": {
"type": [
"boolean",
"null"
]
}
},
"additionalProperties": false
},
"maxItems": 25
},
"source": {
"enum": [
"facebook",
"instagram"
],
"type": "string"
},
"nextCursor": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"updatedAt": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
{
"type": "null"
}
]
},
"campaignId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"draftState": {
"enum": [
"available",
"missing"
],
"type": "string"
},
"generation": {
"anyOf": [
{
"type": "object",
"required": [
"items",
"jobId",
"phase"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"clipDurationSeconds",
"clipStartSeconds",
"errorMessage",
"id",
"progressPercent",
"status",
"templateVariant",
"thumbnailUrl",
"videoUrl"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"status": {
"enum": [
"COMPLETED",
"FAILED",
"PENDING",
"PROCESSING"
],
"type": "string"
},
"videoUrl": {
"type": "string",
"maxLength": 8192
},
"errorMessage": {
"anyOf": [
{
"type": "string",
"maxLength": 2000
},
{
"type": "null"
}
]
},
"thumbnailUrl": {
"type": "string",
"maxLength": 8192
},
"progressPercent": {
"anyOf": [
{
"type": "number",
"maximum": 100,
"minimum": 0
},
{
"type": "null"
}
]
},
"templateVariant": {
"type": "string",
"maxLength": 100
},
"clipStartSeconds": {
"type": "number",
"minimum": 0
},
"clipDurationSeconds": {
"type": "number",
"minimum": 0
}
},
"additionalProperties": false
},
"maxItems": 100
},
"jobId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"phase": {
"enum": [
"ANALYZING_AUDIO",
"CHECKING_RENDERER",
"FAILED",
"FINALIZING",
"PREPARING_TEMPLATES",
"RENDERING"
],
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"setupDraft": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"budgetDraft": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"mediaUpload": {
"anyOf": [
{
"type": "object",
"required": [
"expiresAt",
"key",
"partSizeBytes",
"presignedPartUrls",
"uploadId"
],
"properties": {
"key": {
"type": "string"
},
"uploadId": {
"type": "string"
},
"expiresAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"partSizeBytes": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"presignedPartUrls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
}
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"completed",
"uploadedParts"
],
"properties": {
"completed": {
"type": "boolean"
},
"uploadedParts": {
"type": "array",
"items": {
"type": "object",
"required": [
"etag",
"partNumber",
"sizeBytes"
],
"properties": {
"etag": {
"type": "string"
},
"sizeBytes": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"partNumber": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"etag",
"key",
"mediaAssetId",
"moderationStatus"
],
"properties": {
"key": {
"type": "string"
},
"etag": {
"type": "string"
},
"mediaAssetId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"moderationStatus": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"ok"
],
"properties": {
"ok": {
"type": "boolean",
"const": true
}
},
"additionalProperties": false
}
]
},
"sourceAudio": {
"type": "object",
"required": [
"fileName",
"fileSizeBytes",
"hookSeconds",
"isUploaded",
"trackDurationSeconds"
],
"properties": {
"fileName": {
"type": [
"string",
"null"
]
},
"isUploaded": {
"type": "boolean"
},
"hookSeconds": {
"type": "array",
"items": {
"type": "number"
}
},
"fileSizeBytes": {
"type": [
"number",
"null"
]
},
"trackDurationSeconds": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"uploadStatus": {
"type": "object",
"required": [
"campaignId",
"uploadedParts"
],
"properties": {
"campaignId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"uploadedParts": {
"type": "array",
"items": {
"type": "object",
"required": [
"etag",
"partNumber",
"sizeBytes"
],
"properties": {
"etag": {
"type": "string",
"minLength": 1
},
"sizeBytes": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"partNumber": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"locationDraft": {
"type": "object",
"required": [
"activeStep",
"campaignId",
"location",
"updatedAt"
],
"properties": {
"location": {
"type": "object",
"required": [
"countries",
"mode"
],
"properties": {
"mode": {
"enum": [
"WORLDWIDE",
"INCLUDE"
],
"type": "string"
},
"countries": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"name"
],
"properties": {
"code": {
"type": "string",
"maxLength": 2,
"minLength": 2
},
"name": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"updatedAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"activeStep": {
"enum": [
"location",
"adCopy"
],
"type": "string"
},
"campaignId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"completedSteps": {
"type": "array",
"items": false,
"maxItems": 3,
"minItems": 3,
"prefixItems": [
{
"type": "string",
"const": "content"
},
{
"type": "string",
"const": "creative"
},
{
"type": "string",
"const": "location"
}
]
},
"availableCountries": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"name"
],
"properties": {
"code": {
"type": "string",
"maxLength": 2,
"minLength": 2
},
"name": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
},
"recommendedCountries": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"name"
],
"properties": {
"code": {
"type": "string",
"maxLength": 2,
"minLength": 2
},
"name": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"uploadedAssets": {
"type": "array",
"items": {
"type": "object",
"required": [
"fileName",
"fileSize",
"fileType",
"id",
"mediaAssetId",
"uploadStatus"
],
"properties": {
"id": {
"type": "string",
"default": ""
},
"fileName": {
"type": "string",
"default": ""
},
"fileSize": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0
},
"fileType": {
"type": "string",
"default": ""
},
"mediaAssetId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"uploadStatus": {
"enum": [
"success",
"error"
],
"type": "string"
}
},
"additionalProperties": false
}
},
"generationJobId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"selectedCreativeIds": {
"type": "array",
"items": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"maxItems": 100
},
"selectedSocialPosts": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}{
"name": "dynamoi_prepare_distribution_release",
"title": "Prepare Release Handoff",
"description": "Prepare metadata, tracks and proposed splits for artist review in a private expiring web form. Does not submit a release, attest rights, accept agreements or invite collaborators.",
"inputSchema": {
"type": "object",
"required": [
"artistId",
"desiredReleaseDate",
"hasCollaborators",
"labelName",
"notes",
"releaseTitle",
"releaseType",
"splits",
"tracks"
],
"properties": {
"notes": {
"type": [
"string",
"null"
]
},
"splits": {
"type": "array",
"items": {
"type": "object",
"required": [
"payeeEmail",
"payeeName",
"payeeRole",
"sharePercent"
],
"properties": {
"payeeName": {
"type": "string"
},
"payeeRole": {
"type": [
"string",
"null"
]
},
"payeeEmail": {
"type": "string"
},
"sharePercent": {
"type": "number"
}
},
"additionalProperties": false
}
},
"tracks": {
"type": "array",
"items": {
"type": "object",
"required": [
"isrc",
"title",
"trackNumber",
"versionTitle"
],
"properties": {
"isrc": {
"type": [
"string",
"null"
]
},
"title": {
"type": "string"
},
"trackNumber": {
"type": "number"
},
"versionTitle": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"labelName": {
"type": [
"string",
"null"
]
},
"releaseType": {
"type": "string"
},
"releaseTitle": {
"type": "string"
},
"hasCollaborators": {
"type": "boolean"
},
"desiredReleaseDate": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}| boolean |
{
"name": "dynamoi_apply_for_distribution",
"title": "Apply for Music Distribution",
"description": "Submit an artist's application for Dynamoi music distribution after the user explicitly asks to apply and all five eligibility requirements are met. This records an application for manual review; it does not approve distribution, accept an agreement, submit a release, transfer rights, configure splits or tax forms, or deliver music to stores. All three valid ISO 3166-1 alpha-2 country or territory codes, an adult signer attestation, confirmApplicationSubmission=true, and a concise userIntentSummary are required. Country, tax, payout, sanctions, and provider-delivery checks remain manual progression gates after intake; a valid code does not imply approval. Repeated submission is idempotent for an active application.",
"inputSchema": {
"type": "object",
"required": [
"adultSignerAttestation",
"applicantCountry",
"artistId",
"confirmApplicationSubmission",
"payoutCountry",
"taxResidencyCountry",
"userIntentSummary"
],
"properties": {
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"payoutCountry": {
"type": "string",
"maxLength": 2,
"minLength": 2
},
"applicantCountry": {
"type": "string",
"maxLength": 2,
"minLength": 2
},
"userIntentSummary": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"taxResidencyCountry": {
"type": "string",
"maxLength": 2,
"minLength": 2
},
"adultSignerAttestation": {
"type": "boolean",
"const": true
},
"confirmApplicationSubmission": {
"type": "boolean",
"const": true
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}| expectedTotal * | object |
| returnToBuyer | boolean |
| clientRequestId * | string |
| customTargetViews | integer |
| campaignDurationDays | integer |
| extensionSourceShopOrderId | any |
{
"name": "dynamoi_prepare_shop_rebuy_checkout",
"title": "Prepare Returning Buyer Checkout",
"description": "Preview the selected video, viewer locations and expected total. Use the quote market locale as locale. Confirm only after user approval, keeping the same clientRequestId and expectedTotal. Before opening unpaid Stripe Checkout, Dynamoi checks the current total and applies its existing buyer-offer and purchase-email rules. Creating checkout does not pay, create an order or launch a promotion. Reconcile uncertain outcomes with the original request ID and exact input.",
"inputSchema": {
"type": "object",
"required": [
"locale",
"tier",
"youtubeUrl",
"expectedTotal",
"shopSlug",
"clientRequestId",
"artistId"
],
"properties": {
"tier": {
"type": "string",
"maxLength": 32,
"minLength": 1
},
"phase": {
"enum": [
"preview",
"confirm"
],
"type": "string",
"default": "preview"
},
"locale": {
"type": "string",
"maxLength": 35,
"minLength": 2
},
"artistId": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"shopSlug": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"youtubeUrl": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"countryMode": {
"enum": [
"GLOBAL",
"INCLUDE"
],
"type": "string"
},
"countryCodes": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"maxItems": 50
},
"contentLocale": {
"type": "string",
"maxLength": 35,
"minLength": 2
},
"expectedTotal": {
"type": "object",
"required": [
"amountCents",
"currency"
],
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"amountCents": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"returnToBuyer": {
"type": "boolean",
"default": true
},
"clientRequestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"customTargetViews": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"campaignDurationDays": {
"type": "integer",
"maximum": 30,
"minimum": 7
},
"extensionSourceShopOrderId": {
"anyOf": [
{
"type": "string",
"maxLength": 255,
"minLength": 1
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"required": [
"phase"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"phase": {
"enum": [
"preview",
"created"
],
"type": "string"
},
"proposed": {
"type": "object",
"required": [
"locale",
"tier",
"youtubeUrl",
"expectedTotal",
"shopSlug",
"returnToBuyer",
"clientRequestId"
],
"properties": {
"tier": {
"type": "string",
"maxLength": 32,
"minLength": 1
},
"locale": {
"type": "string",
"maxLength": 35,
"minLength": 2
},
"shopSlug": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"youtubeUrl": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"countryMode": {
"enum": [
"GLOBAL",
"INCLUDE"
],
"type": "string"
},
"countryCodes": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"maxItems": 50
},
"contentLocale": {
"type": "string",
"maxLength": 35,
"minLength": 2
},
"expectedTotal": {
"type": "object",
"required": [
"amountCents",
"currency"
],
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"amountCents": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"returnToBuyer": {
"type": "boolean",
"default": true
},
"clientRequestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"customTargetViews": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"campaignDurationDays": {
"type": "integer",
"maximum": 30,
"minimum": 7
},
"extensionSourceShopOrderId": {
"anyOf": [
{
"type": "string",
"maxLength": 255,
"minLength": 1
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}{
"name": "dynamoi_pause_shop_promotion",
"title": "Pause Shop Promotion",
"description": "Preview a Shop promotion pause. Requires editor access and full profile. Inspect the preview with the user, then confirm with the same clientRequestId and expectedCampaignStatus. Existing paid-order, provider and restart safeguards remain authoritative. Restart requires youtubeUrl and targetingConfirmed=true. Queues the existing job; no payment or refund. Reuse the original request ID when reconciling an uncertain result.",
"inputSchema": {
"type": "object",
"required": [
"campaignId",
"shopOrderId",
"clientRequestId",
"artistId"
],
"properties": {
"phase": {
"enum": [
"preview",
"confirm"
],
"type": "string",
"default": "preview"
},
"artistId": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"campaignId": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"youtubeUrl": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"shopOrderId": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"clientRequestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"targetingConfirmed": {
"type": "boolean"
},
"expectedCampaignStatus": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"required": [
"phase"
],
"properties": {
"phase": {
"enum": [
"preview",
"confirmed"
],
"type": "string"
},
"action": {
"enum": [
"pause",
"resume",
"restart"
],
"type": "string"
},
"outcome": {
"enum": [
"duplicate",
"queued"
],
"type": "string"
},
"expected": {
"type": "object",
"required": [
"expectedCampaignStatus"
],
"properties": {
"expectedCampaignStatus": {
"type": "string"
}
},
"additionalProperties": false
},
"proposed": {
"type": "object",
"required": [
"campaignId",
"shopOrderId",
"action"
],
"properties": {
"action": {
"enum": [
"pause",
"resume",
"restart"
],
"type": "string"
},
"campaignId": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"youtubeUrl": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"shopOrderId": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"targetingConfirmed": {
"type": "boolean"
}
},
"additionalProperties": false
},
"currentCampaignStatus": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}{
"name": "dynamoi_resume_shop_promotion",
"title": "Resume Shop Promotion",
"description": "Preview a Shop promotion resume. Requires editor access and full profile. Inspect the preview with the user, then confirm with the same clientRequestId and expectedCampaignStatus. Existing paid-order, provider and restart safeguards remain authoritative. Restart requires youtubeUrl and targetingConfirmed=true. Queues the existing job; no payment or refund. Reuse the original request ID when reconciling an uncertain result.",
"inputSchema": {
"type": "object",
"required": [
"campaignId",
"shopOrderId",
"clientRequestId",
"artistId"
],
"properties": {
"phase": {
"enum": [
"preview",
"confirm"
],
"type": "string",
"default": "preview"
},
"artistId": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"campaignId": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"youtubeUrl": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"shopOrderId": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"clientRequestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"targetingConfirmed": {
"type": "boolean"
},
"expectedCampaignStatus": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"required": [
"phase"
],
"properties": {
"phase": {
"enum": [
"preview",
"confirmed"
],
"type": "string"
},
"action": {
"enum": [
"pause",
"resume",
"restart"
],
"type": "string"
},
"outcome": {
"enum": [
"duplicate",
"queued"
],
"type": "string"
},
"expected": {
"type": "object",
"required": [
"expectedCampaignStatus"
],
"properties": {
"expectedCampaignStatus": {
"type": "string"
}
},
"additionalProperties": false
},
"proposed": {
"type": "object",
"required": [
"campaignId",
"shopOrderId",
"action"
],
"properties": {
"action": {
"enum": [
"pause",
"resume",
"restart"
],
"type": "string"
},
"campaignId": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"youtubeUrl": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"shopOrderId": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"targetingConfirmed": {
"type": "boolean"
}
},
"additionalProperties": false
},
"currentCampaignStatus": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}{
"name": "dynamoi_restart_shop_promotion",
"title": "Restart Shop Promotion",
"description": "Preview a Shop promotion restart. Requires editor access and full profile. Inspect the preview with the user, then confirm with the same clientRequestId and expectedCampaignStatus. Existing paid-order, provider and restart safeguards remain authoritative. Restart requires youtubeUrl and targetingConfirmed=true. Queues the existing job; no payment or refund. Reuse the original request ID when reconciling an uncertain result.",
"inputSchema": {
"type": "object",
"required": [
"campaignId",
"shopOrderId",
"youtubeUrl",
"targetingConfirmed",
"clientRequestId",
"artistId"
],
"properties": {
"phase": {
"enum": [
"preview",
"confirm"
],
"type": "string",
"default": "preview"
},
"artistId": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"campaignId": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"youtubeUrl": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"shopOrderId": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"clientRequestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"targetingConfirmed": {
"type": "boolean",
"const": true
},
"expectedCampaignStatus": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"required": [
"phase"
],
"properties": {
"phase": {
"enum": [
"preview",
"confirmed"
],
"type": "string"
},
"action": {
"enum": [
"pause",
"resume",
"restart"
],
"type": "string"
},
"outcome": {
"enum": [
"duplicate",
"queued"
],
"type": "string"
},
"expected": {
"type": "object",
"required": [
"expectedCampaignStatus"
],
"properties": {
"expectedCampaignStatus": {
"type": "string"
}
},
"additionalProperties": false
},
"proposed": {
"type": "object",
"required": [
"campaignId",
"shopOrderId",
"action"
],
"properties": {
"action": {
"enum": [
"pause",
"resume",
"restart"
],
"type": "string"
},
"campaignId": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"youtubeUrl": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"shopOrderId": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"targetingConfirmed": {
"type": "boolean"
}
},
"additionalProperties": false
},
"currentCampaignStatus": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}{
"name": "dynamoi_create_smart_link_from_spotify",
"title": "Create Free Smart Link from Spotify",
"description": "Use this for \"make a link for my song\" or a release or link-in-bio page for a new single. Use this when the user wants to create one free Dynamoi Smart Link from a Spotify album or track URL/URI, or a single starter release from a Spotify artist URL. For full-catalog artist imports or artist hub requests, prefer dynamoi_create_smart_links_from_spotify_artist. Smart Links are free to create and manage. High-popularity or unverifiable artist links may stay unpublished in verification hold until Dynamoi can verify the client relationship. This does not create a paid ad campaign. Spotify playlist URLs are not supported today. This is also how to add a release missing from an artist's imported catalog: the user pastes that release's exact Spotify album, single, or EP URL. If the Smart Link already exists, return the existing link instead of creating a duplicate; if customDescription is provided, update that Smart Link's public description. In the final answer, lead with the public URL and do not expose internal IDs unless asked.",
"inputSchema": {
"type": "object",
"required": [
"artistId",
"spotifyUrl"
],
"properties": {
"format": {
"enum": [
"json",
"summary"
],
"type": "string"
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"spotifyUrl": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"clientRequestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"customDescription": {
"type": "string",
"maxLength": 500
},
"userIntentSummary": {
"type": "string",
"maxLength": 500
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"required": [
"artistHubUrl",
"artistId",
"artistName",
"claimStatus",
"createdAt",
"id",
"isPublic",
"publicUrl",
"publishState",
"releaseSlug",
"releaseTitle",
"releaseType",
"renderState",
"spotifyUrl",
"takedownStatus",
"theme",
"updatedAt",
"customDescription",
"nextActions",
"originalSpotifyUrl",
"summary",
"outcome",
"workflowWarning"
],
"properties": {
"id": {
"type": "string"
},
"theme": {
"enum": [
"classic",
"brutalist",
"aurora",
"cinematic"
],
"type": "string"
},
"outcome": {
"enum": [
"created",
"existing"
],
"type": "string"
},
"summary": {
"type": "string"
},
"artistId": {
"type": "string"
},
"isPublic": {
"type": "boolean"
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"createdAt": {
"type": "string"
},
"publicUrl": {
"type": "string"
},
"updatedAt": {
"type": "string"
},
"artistName": {
"type": "string"
},
"spotifyUrl": {
"type": [
"string",
"null"
]
},
"claimStatus": {
"enum": [
"auto_approved",
"pending_ops_review",
"verification_deferred",
"approved_by_ops",
"rejected"
],
"type": "string"
},
"nextActions": {
"type": "array",
"items": {
"type": "string"
}
},
"releaseSlug": {
"type": "string"
},
"releaseType": {
"type": "string"
},
"renderState": {
"enum": [
"queued",
"rendering",
"rendered",
"failed"
],
"type": "string"
},
"artistHubUrl": {
"type": "string"
},
"publishState": {
"enum": [
"published",
"unpublished"
],
"type": "string"
},
"releaseTitle": {
"type": "string"
},
"actionRequired": {
"type": "array",
"items": {
"type": "string"
}
},
"takedownStatus": {
"enum": [
"none",
"active",
"resolved"
],
"type": "string"
},
"workflowWarning": {
"type": [
"string",
"null"
]
},
"customDescription": {
"type": [
"string",
"null"
]
},
"originalSpotifyUrl": {
"type": [
"string",
"null"
]
},
"localizedPublicUrls": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}| clientRequestId | string |
| spotifyArtistUrl * | string |
| userIntentSummary | string |
{
"name": "dynamoi_create_smart_links_from_spotify_artist",
"title": "Create Free Smart Links for Spotify Artist",
"description": "Preview at most 25 Spotify album/single Smart Links, then show the exact count, titles and existing/new counts to the user. Creation requires a separate confirmed call with phase=confirm, the returned previewId and confirmedCount matching count. Preview creates no artist or Smart Links. Omit artistId to create the first artist only after confirmation. The target list is frozen; one confirmation never starts an unbounded catalog job. A nextOffset requires a new preview and confirmation. Retain the exact original request and clientRequestId for replay, including the original short URL. Replays observe the saved plan before URL resolution. First-artist previews include the reviewed workspace and confirmation cannot choose another. Only settlement=expired_before_execution proves an expired preview started no catalog writes; a generic conflict, timeout or local expiry does not. An in-progress or ambiguous result retains its key and never starts another write. Smart Links are free and may remain in verification hold. Lead with public URLs; this does not create a paid campaign.",
"inputSchema": {
"type": "object",
"required": [
"spotifyArtistUrl"
],
"properties": {
"limit": {
"type": "integer",
"default": 25,
"maximum": 25,
"minimum": 1
},
"phase": {
"enum": [
"preview",
"confirm"
],
"type": "string",
"default": "preview"
},
"format": {
"enum": [
"json",
"summary"
],
"type": "string"
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 10000,
"minimum": 0
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"previewId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"confirmedCount": {
"type": "integer",
"maximum": 25,
"minimum": 0
},
"clientRequestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"spotifyArtistUrl": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"userIntentSummary": {
"type": "string",
"maxLength": 500
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"required": [
"artistId",
"count",
"existingCount",
"expiresAt",
"items",
"message",
"newCount",
"nextOffset",
"previewId",
"spotifyArtistUrl",
"status",
"targets"
],
"properties": {
"count": {
"type": "integer",
"maximum": 25,
"minimum": 0
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"message",
"playLinkId",
"publicUrl",
"spotifyUrl",
"status"
],
"properties": {
"status": {
"enum": [
"created",
"existing",
"failed"
],
"type": "string"
},
"message": {
"type": [
"string",
"null"
]
},
"publicUrl": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
},
"playLinkId": {
"type": [
"string",
"null"
]
},
"spotifyUrl": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
},
"maxItems": 25
},
"status": {
"enum": [
"preview",
"completed",
"in_progress",
"failed"
],
"type": "string"
},
"message": {
"type": "string"
},
"receipt": {
"type": "object",
"required": [
"artistId",
"clientRequestId",
"inputKind",
"limit",
"offset",
"spotifyArtistId",
"spotifyArtistUrl"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"artistId": {
"type": [
"string",
"null"
]
},
"inputKind": {
"enum": [
"spotify_url",
"connected_artist"
],
"type": "string"
},
"clientRequestId": {
"type": [
"string",
"null"
]
},
"spotifyArtistId": {
"type": "string"
},
"spotifyArtistUrl": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"targets": {
"type": "array",
"items": {
"type": "object",
"required": [
"existing",
"releaseName",
"spotifyUrl"
],
"properties": {
"existing": {
"type": "boolean"
},
"spotifyUrl": {
"type": "string",
"format": "uri"
},
"releaseName": {
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 25
},
"artistId": {
"type": [
"string",
"null"
]
},
"newCount": {
"type": "integer",
"maximum": 25,
"minimum": 0
},
"expiresAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"previewId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"workspace": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"organizationId",
"organizationName"
],
"properties": {
"kind": {
"type": "string",
"const": "existing"
},
"organizationId": {
"type": "string"
},
"organizationName": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"type": "string",
"const": "new"
}
},
"additionalProperties": false
}
]
},
"nextOffset": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"settlement": {
"type": "string",
"const": "expired_before_execution"
},
"existingCount": {
"type": "integer",
"maximum": 25,
"minimum": 0
},
"spotifyArtistUrl": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}{
"name": "dynamoi_list_smart_links",
"title": "List Smart Links",
"description": "Use this when the user wants to list free Smart Links for one artist, including release title, public URL, publish state, claim state, render state, and theme. Do not use this for paid campaign lists; use dynamoi_list_campaigns for campaigns. In the final answer, show public URLs and avoid internal IDs unless asked. If empty for an artist with connected Spotify, suggest dynamoi_create_smart_links_from_spotify_artist for catalog import or dynamoi_create_smart_link_from_spotify for one release instead of stopping at 'no Smart Links yet'.",
"inputSchema": {
"type": "object",
"required": [
"artistId"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 120
},
"cursor": {
"type": "string"
},
"format": {
"enum": [
"json",
"summary"
],
"type": "string"
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"claimStatus": {
"enum": [
"auto_approved",
"pending_ops_review",
"verification_deferred",
"approved_by_ops",
"rejected"
],
"type": "string"
},
"renderState": {
"enum": [
"queued",
"rendering",
"rendered",
"failed"
],
"type": "string"
},
"publishState": {
"enum": [
"published",
"unpublished"
],
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"anyOf": [
{
"type": "object",
"required": [
"smartLinks"
],
"properties": {
"nextCursor": {
"type": "string"
},
"smartLinks": {
"type": "array",
"items": {
"type": "object",
"required": [
"artistHubUrl",
"artistId",
"artistName",
"claimStatus",
"createdAt",
"id",
"isPublic",
"publicUrl",
"publishState",
"releaseSlug",
"releaseTitle",
"releaseType",
"renderState",
"spotifyUrl",
"takedownStatus",
"theme",
"updatedAt"
],
"properties": {
"id": {
"type": "string"
},
"theme": {
"enum": [
"classic",
"brutalist",
"aurora",
"cinematic"
],
"type": "string"
},
"artistId": {
"type": "string"
},
"isPublic": {
"type": "boolean"
},
"createdAt": {
"type": "string"
},
"publicUrl": {
"type": "string"
},
"updatedAt": {
"type": "string"
},
"artistName": {
"type": "string"
},
"spotifyUrl": {
"type": [
"string",
"null"
]
},
"claimStatus": {
"enum": [
"auto_approved",
"pending_ops_review",
"verification_deferred",
"approved_by_ops",
"rejected"
],
"type": "string"
},
"releaseSlug": {
"type": "string"
},
"releaseType": {
"type": "string"
},
"renderState": {
"enum": [
"queued",
"rendering",
"rendered",
"failed"
],
"type": "string"
},
"artistHubUrl": {
"type": "string"
},
"publishState": {
"enum": [
"published",
"unpublished"
],
"type": "string"
},
"releaseTitle": {
"type": "string"
},
"takedownStatus": {
"enum": [
"none",
"active",
"resolved"
],
"type": "string"
},
"localizedPublicUrls": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"summary",
"totalCount"
],
"properties": {
"summary": {
"type": "string"
},
"nextCursor": {
"type": "string"
},
"totalCount": {
"type": "number"
}
},
"additionalProperties": false
}
]
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}{
"name": "dynamoi_get_smart_link",
"title": "Get Smart Link",
"description": "Use this when the user wants full details for one free Smart Link, including release, Spotify URL, public play.dynamoi.com URL, current status, theme source, and next actions. Set includeAnalytics=true for visit/click analytics and includeArtistSettings=true for artist-level theme/pixel settings. In the final answer, lead with the public URL and do not expose internal IDs unless asked.",
"inputSchema": {
"type": "object",
"properties": {
"format": {
"enum": [
"json",
"summary"
],
"type": "string"
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"dateRange": {
"type": "object",
"required": [
"end",
"start"
],
"properties": {
"end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"additionalProperties": false
},
"playLinkId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"spotifyUrl": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"granularity": {
"enum": [
"TOTAL",
"DAILY"
],
"type": "string"
},
"includeAnalytics": {
"type": "boolean"
},
"includeBreakdowns": {
"type": "boolean"
},
"includeArtistSettings": {
"type": "boolean"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}| string |
| googleAdsConversionId | any |
{
"name": "dynamoi_update_smart_link",
"title": "Update Smart Link",
"description": "Use this when the user wants to change one Smart Link's public description or update artist-level Smart Link theme/pixel settings. Set action to update_description or update_artist_settings. Public availability requires both artist-wide availability and per-release publication; this tool does not publish or unpublish individual links. Theme-only updates switch instantly; description or pixel changes may queue background rendering.",
"inputSchema": {
"type": "object",
"required": [
"action"
],
"properties": {
"theme": {
"enum": [
"classic",
"brutalist",
"aurora",
"cinematic"
],
"type": "string"
},
"action": {
"enum": [
"update_description",
"update_artist_settings"
],
"type": "string"
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"playLinkId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"metaPixelId": {
"anyOf": [
{
"type": "string",
"maxLength": 32
},
{
"type": "null"
}
]
},
"tiktokPixelId": {
"anyOf": [
{
"type": "string",
"maxLength": 32
},
{
"type": "null"
}
]
},
"clientRequestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"customDescription": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
},
"expectedUpdatedAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"userIntentSummary": {
"type": "string",
"maxLength": 500
},
"googleAdsConversionId": {
"anyOf": [
{
"type": "string",
"maxLength": 32
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}| isEnabled | boolean |
| previewId | string |
| playLinkId | string |
| confirmedCount | integer |
| clientRequestId | string |
| expectedVersion | string |
{
"name": "dynamoi_smart_link_controls",
"title": "Smart Link Controls",
"description": "Sync the native catalog, change artist-wide Smart Link availability, replace tracking IDs, or record a promote request. Confirm the requested change first. Before disabling, preview which artist hub and release Smart Links go offline, then send confirm: true after the user confirms. Tracking requires all three IDs (null clears) and forwards expectedVersion from artistHub.version. Availability is unversioned. Catalog sync previews at most 25 frozen links. Show the exact count and titles, then repeat the original limit/offset with phase=confirm, previewId and matching confirmedCount. No background catalog continuation is started; another batch requires a new preview and confirmation. Promote request requires playLinkId; it only records the native platform analytics event, sends no message and starts no paid work. Omitted platform uses the native default (iOS).",
"inputSchema": {
"type": "object",
"required": [
"action",
"artistId"
],
"properties": {
"limit": {
"type": "integer",
"default": 25,
"maximum": 25,
"minimum": 1
},
"phase": {
"enum": [
"preview",
"confirm"
],
"type": "string",
"default": "preview"
},
"action": {
"enum": [
"sync_catalog",
"set_availability",
"update_tracking",
"promote_request"
],
"type": "string"
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 10000,
"minimum": 0
},
"confirm": {
"type": "boolean"
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"platform": {
"anyOf": [
{
"enum": [
"ios",
"android"
],
"type": "string"
},
{
"type": "null"
}
]
},
"tracking": {
"type": "object",
"required": [
"googleAdsConversionId",
"metaPixelId",
"tiktokPixelId"
],
"properties": {
"metaPixelId": {
"anyOf": [
{
"type": "string",
"maxLength": 32
},
{
"type": "null"
}
]
},
"tiktokPixelId": {
"anyOf": [
{
"type": "string",
"maxLength": 32
},
{
"type": "null"
}
]
},
"googleAdsConversionId": {
"anyOf": [
{
"type": "string",
"maxLength": 32
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"isEnabled": {
"type": "boolean"
},
"previewId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"playLinkId": {
"type": "string",
"minLength": 1
},
"confirmedCount": {
"type": "integer",
"maximum": 25,
"minimum": 0
},
"clientRequestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"expectedVersion": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}| userIntentSummary |
| string |
| servicePriorityMode | string | one of ["country","fixed"] |
| googleAdsConversionId | any |
{
"name": "dynamoi_update_smart_link_artist_hub_settings",
"title": "Update Smart Link Artist Hub Settings",
"description": "Use this when the user wants to change artist Smart Link theme, pixels, introduction, official profile links or service order. Pass the read artistHub.version as expectedVersion. Omitted fields preserve stored values; null explicitly clears supported fields. Confirm the requested settings before calling. The result includes the saved artistHub readback. If the theme applies but other changes are refused, reload with dynamoi_get_smart_link (artistId, includeArtistSettings=true) before retrying.",
"inputSchema": {
"type": "object",
"required": [
"artistId"
],
"properties": {
"theme": {
"enum": [
"classic",
"brutalist",
"aurora",
"cinematic"
],
"type": "string"
},
"artistId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"metaPixelId": {
"anyOf": [
{
"type": "string",
"maxLength": 32
},
{
"type": "null"
}
]
},
"profileLinks": {
"type": "array",
"items": {
"type": "object",
"required": [
"isHidden",
"service",
"url"
],
"properties": {
"url": {
"anyOf": [
{
"type": "string",
"maxLength": 1024
},
{
"type": "null"
}
]
},
"service": {
"enum": [
"spotify",
"applemusic",
"youtube",
"instagram",
"facebook",
"tiktok",
"soundcloud",
"bandcamp",
"deezer",
"tidal",
"boomplay",
"audiomack"
],
"type": "string"
},
"isHidden": {
"type": "boolean"
}
},
"additionalProperties": false
},
"maxItems": 12
},
"tiktokPixelId": {
"anyOf": [
{
"type": "string",
"maxLength": 32
},
{
"type": "null"
}
]
},
"hubDescription": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
},
"clientRequestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"expectedVersion": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"servicePriority": {
"type": "array",
"items": {
"type": "string",
"maxLength": 32
},
"maxItems": 4
},
"userIntentSummary": {
"type": "string",
"maxLength": 500
},
"servicePriorityMode": {
"enum": [
"country",
"fixed"
],
"type": "string"
},
"googleAdsConversionId": {
"anyOf": [
{
"type": "string",
"maxLength": 32
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}{
"name": "dynamoi_update_smart_link_release_settings",
"title": "Update Smart Link Release Settings",
"description": "Use this when the user wants to change one Smart Link's release video or catalog destination visibility. Pass the read version as expectedVersion. Set any of customDescription, youtubeUrl or serviceOverrides; omitted fields preserve stored values and null explicitly clears supported fields. Public availability requires both artist-wide availability and per-release publication; this tool does not publish or unpublish individual links. Confirm the requested settings before calling. The result includes the saved releaseSettings readback; after an ambiguous failure, read it with dynamoi_get_smart_link (playLinkId; see releaseSettings) before retrying. A description or video change may queue background rendering.",
"inputSchema": {
"type": "object",
"required": [
"playLinkId"
],
"properties": {
"playLinkId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"youtubeUrl": {
"anyOf": [
{
"type": "string",
"maxLength": 512
},
{
"type": "null"
}
]
},
"clientRequestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"expectedVersion": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"serviceOverrides": {
"type": "array",
"items": {
"type": "object",
"required": [
"hidden",
"service",
"url"
],
"properties": {
"url": {
"anyOf": [
{
"type": "string",
"maxLength": 1024
},
{
"type": "null"
}
]
},
"hidden": {
"type": "boolean"
},
"service": {
"type": "string",
"maxLength": 32
}
},
"additionalProperties": false
},
"maxItems": 15
},
"customDescription": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "null"
}
]
},
"expectedUpdatedAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
},
"userIntentSummary": {
"type": "string",
"maxLength": 500
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"code": {
"enum": [
"ACCOUNT_READ_ONLY",
"INVALID_SPOTIFY_SOURCE",
"CAPABILITY_REQUIRED",
"INSUFFICIENT_SCOPE",
"TENANT_ACCESS_DENIED",
"STATE_CONFLICT",
"QUOTE_CHANGED",
"RATE_LIMITED",
"OUTPUT_INVALID",
"UNKNOWN_EFFECT"
],
"type": "string"
},
"data": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"kind": {
"enum": [
"validation",
"business",
"platform",
"unknown"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"status": {
"enum": [
"success",
"partial_success",
"error"
],
"type": "string"
},
"draftId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"nextAction": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"provide_input",
"read_status",
"reconnect",
"handoff"
],
"type": "string"
},
"field": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"reason": {
"type": "string",
"maxLength": 240,
"minLength": 1
}
},
"additionalProperties": false
},
"failureStage": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"prerequisite": {
"type": "string",
"maxLength": 240,
"minLength": 1
},
"screeningResult": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 0
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}