{
"detail": "platform_id cannot be changed on an existing credential. The stored provider account, the credential's identity and the shape of the stored secret all belong to one platform. Create a credential for the other platform instead."
}
{
"detail": "Authentication required"
}
{
"detail": "Admin role required"
}
{
"detail": "Credential not found"
}
{
"detail": "The new material belongs to a different provider account or identity than this credential is bound to. Create a separate credential for it instead of rotating this one."
}
{
"detail": "Rate limit exceeded: 100 per 1 minute"
}
Credentials — /v1/credentials
Update a credential
Update a credential’s name, status and authentication configuration. Admin only.
Supply credentials to ROTATE the stored secret. The new material replaces the old in place: the credential keeps its id and keeps pointing at the same stored secret, so every flow that uses this credential picks the new material up with no flow edit, no re-selection and no redeployment. Running workers refresh their cached copy within five minutes.
Rotating an OAuth2 credential also clears its cached access token, so the next run fetches a fresh token with the new material. Tokens the provider has already issued are not revoked here and remain valid until they expire on the provider’s own schedule.
Rotation keeps the credential’s provider-account binding, so the new material must belong to the same provider account and identity as the old. When the platform can identify the account credentials belong to, the new material is verified against it during the rotation: material that resolves to a different account or identity is refused with a 409 — create a separate credential for it instead.
Rotating clears the credential’s last verification time, because the recorded check described the previous material. Run a test to record a fresh one.
platform_id must match the stored value — a credential belongs to one platform for its whole life. Server-managed fields (the provider account binding, the stored-secret pointer, the observed-use record) cannot be set from a request body and are preserved. Cross-tenant access returns 404.
{
"detail": "platform_id cannot be changed on an existing credential. The stored provider account, the credential's identity and the shape of the stored secret all belong to one platform. Create a credential for the other platform instead."
}
{
"detail": "Authentication required"
}
{
"detail": "Admin role required"
}
{
"detail": "Credential not found"
}
{
"detail": "The new material belongs to a different provider account or identity than this credential is bound to. Create a separate credential for it instead of rotating this one."
}
This is presentation configuration, not secret material: it holds the header
NAME (and optionally a scheme such as Bearer prefixed to the value), or the
query-parameter NAME. A form renders straight from it.
It is declared ONCE, on the credential, so every task that selects this
credential injects the key identically and no task configuration ever
mentions authentication. Exactly one of header_name or query_param is
set; scheme is legal only alongside header_name.
This is presentation configuration, not secret material: it holds the header
NAME (and optionally a scheme such as Bearer prefixed to the value), or the
query-parameter NAME. A form renders straight from it.
It is declared ONCE, on the credential, so every task that selects this
credential injects the key identically and no task configuration ever
mentions authentication. Exactly one of header_name or query_param is
set; scheme is legal only alongside header_name.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"GetDialed Docs","colors":{"primary":"#4F46E5","light":"#818CF8","dark":"#3730A3"},"logo":{"light":"https://mintcdn.com/getdialed/aL0yqdSUKnvM2urY/logo/light.svg?fit=max\u0026auto=format\u0026n=aL0yqdSUKnvM2urY\u0026q=85\u0026s=f6bd462ed94234572b2ef5546432f2e6","dark":"https://mintcdn.com/getdialed/aL0yqdSUKnvM2urY/logo/dark.svg?fit=max\u0026auto=format\u0026n=aL0yqdSUKnvM2urY\u0026q=85\u0026s=d1c6a3c7e0c6c51c197026d4f6e5828b","href":"https://getdialed.ai"},"favicon":"https://mintcdn.com/getdialed/hCWbIPF0pnvtMb9m/favicon.ico?fit=max\u0026auto=format\u0026n=hCWbIPF0pnvtMb9m\u0026q=85\u0026s=f2bdd6a91d61e358c1f0958dfa3a7ba6","footer":{"socials":{"website":"https://getdialed.ai"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"getdialed","hasAudioNarration":false,"actualSubdomain":"getdialed","customDomains":["docs.getdialed.ai"],"gitSource":{"type":"gitlab","owner":"getdialed","repo":"gdf","deployBranch":"master","contentDirectory":"docs-site","isPrivate":true,"projectId":79547483,"mountPath":"","label":""},"chroma":{"collectionId":"e7cf6d55-9268-46be-aa47-d76035f822d6","liveDeploymentHistoryId":"6accf41d5f90b4d42c2fc095","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6accf41d5f90b4d42c2fc095"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ada2fd916a91434b90658d1","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"default","tag":"API Reference","count":114},{"language":"default","tag":"Flows — /v1/flows","count":56},{"language":"default","tag":"Documentation","count":42},{"language":"default","tag":"Core Concepts","count":28},{"language":"default","tag":"Data — /v1/data","count":13},{"language":"default","tag":"Five9 Domains — /v1/platforms/five9","count":13},{"language":"default","tag":"Batches","count":10},{"language":"default","tag":"Webhooks","count":9},{"language":"default","tag":"Variables","count":8},{"language":"default","tag":"Admin — /v1/admin","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#navbar a[href=\"https://getdialed.ai\"] img,#navbar .nav-logo img,#navbar .nav-logo{height:2.75rem!important;max-height:2.75rem!important}#navbar a[href=\"https://getdialed.ai\"]{display:flex;align-items:center;gap:0.6rem}#navbar a[href=\"https://getdialed.ai\"]::after{content:\"Docs\";font-size:0.875rem;font-weight:500;color:#64748b;line-height:1}html.dark #navbar a[href=\"https://getdialed.ai\"]::after{color:#94a3b8}"}],"page":{"pagePath":"api-reference/credentials/update-a-credential","slug":"/api-reference/credentials/update-a-credential","pageMetadata":{"title":"Update a credential","description":"Update a credential's name, status and authentication configuration. Admin only.\n\nSupply `credentials` to ROTATE the stored secret. The new material replaces the old in place: the credential keeps its id and keeps pointing at the same stored secret, so every flow that uses this credential picks the new material up with no flow edit, no re-selection and no redeployment. Running workers refresh their cached copy within five minutes.\n\nRotating an OAuth2 credential also clears its cached access token, so the next run fetches a fresh token with the new material. Tokens the provider has already issued are not revoked here and remain valid until they expire on the provider's own schedule.\n\nRotation keeps the credential's provider-account binding, so the new material must belong to the same provider account and identity as the old. When the platform can identify the account credentials belong to, the new material is verified against it during the rotation: material that resolves to a different account or identity is refused with a 409 — create a separate credential for it instead.\n\nRotating clears the credential's last verification time, because the recorded check described the previous material. Run a test to record a fresh one.\n\n`platform_id` must match the stored value — a credential belongs to one platform for its whole life. Server-managed fields (the provider account binding, the stored-secret pointer, the observed-use record) cannot be set from a request body and are preserved. Cross-tenant access returns 404.","deprecated":null,"version":null,"openapi":"/openapi.json put /credentials/{credential_id}","href":"/api-reference/credentials/update-a-credential","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Update a credential’s name, status and authentication configuration. Admin only.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Supply \", _jsx(_components.code, {\n children: \"credentials\"\n }), \" to ROTATE the stored secret. The new material replaces the old in place: the credential keeps its id and keeps pointing at the same stored secret, so every flow that uses this credential picks the new material up with no flow edit, no re-selection and no redeployment. Running workers refresh their cached copy within five minutes.\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Rotating an OAuth2 credential also clears its cached access token, so the next run fetches a fresh token with the new material. Tokens the provider has already issued are not revoked here and remain valid until they expire on the provider’s own schedule.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Rotation keeps the credential’s provider-account binding, so the new material must belong to the same provider account and identity as the old. When the platform can identify the account credentials belong to, the new material is verified against it during the rotation: material that resolves to a different account or identity is refused with a 409 — create a separate credential for it instead.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Rotating clears the credential’s last verification time, because the recorded check described the previous material. Run a test to record a fresh one.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.code, {\n children: \"platform_id\"\n }), \" must match the stored value — a credential belongs to one platform for its whole life. Server-managed fields (the provider account binding, the stored-secret pointer, the observed-use record) cannot be set from a request body and are preserved. Cross-tenant access returns 404.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Update a credential","description":"Update a credential's name, status and authentication configuration. Admin only.\n\nSupply `credentials` to ROTATE the stored secret. The new material replaces the old in place: the credential keeps its id and keeps pointing at the same stored secret, so every flow that uses this credential picks the new material up with no flow edit, no re-selection and no redeployment. Running workers refresh their cached copy within five minutes.\n\nRotating an OAuth2 credential also clears its cached access token, so the next run fetches a fresh token with the new material. Tokens the provider has already issued are not revoked here and remain valid until they expire on the provider's own schedule.\n\nRotation keeps the credential's provider-account binding, so the new material must belong to the same provider account and identity as the old. When the platform can identify the account credentials belong to, the new material is verified against it during the rotation: material that resolves to a different account or identity is refused with a 409 — create a separate credential for it instead.\n\nRotating clears the credential's last verification time, because the recorded check described the previous material. Run a test to record a fresh one.\n\n`platform_id` must match the stored value — a credential belongs to one platform for its whole life. Server-managed fields (the provider account binding, the stored-secret pointer, the observed-use record) cannot be set from a request body and are preserved. Cross-tenant access returns 404.","deprecated":null,"version":null,"openapi":"/openapi.json put /credentials/{credential_id}","href":"/api-reference/credentials/update-a-credential","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["credentials"],"summary":"Update a credential","description":"Update a credential's name, status and authentication configuration. Admin only.\n\nSupply `credentials` to ROTATE the stored secret. The new material replaces the old in place: the credential keeps its id and keeps pointing at the same stored secret, so every flow that uses this credential picks the new material up with no flow edit, no re-selection and no redeployment. Running workers refresh their cached copy within five minutes.\n\nRotating an OAuth2 credential also clears its cached access token, so the next run fetches a fresh token with the new material. Tokens the provider has already issued are not revoked here and remain valid until they expire on the provider's own schedule.\n\nRotation keeps the credential's provider-account binding, so the new material must belong to the same provider account and identity as the old. When the platform can identify the account credentials belong to, the new material is verified against it during the rotation: material that resolves to a different account or identity is refused with a 409 — create a separate credential for it instead.\n\nRotating clears the credential's last verification time, because the recorded check described the previous material. Run a test to record a fresh one.\n\n`platform_id` must match the stored value — a credential belongs to one platform for its whole life. Server-managed fields (the provider account binding, the stored-secret pointer, the observed-use record) cannot be set from a request body and are preserved. Cross-tenant access returns 404.","operationId":"update_credential_credentials__credential_id__put","security":["3c0ed92d-da35-4a10-b58b-9b9db2dbd23c","7a94cd3e-640e-4606-a636-3c2ce84caf3c"],"parameters":["6e5cb754-95d5-427f-9ba6-5a851ce76825"],"requestBody":"52690fd4-1f61-4b14-8d5e-cf33f98aa529","responses":{"200":"37dfab3e-61c4-4cf1-b558-4398c2fa00ae","400":"c23b4330-2221-46f6-8a94-879a85b8fc3b","401":"5fd8d767-6b5a-4467-88df-289daacc115f","403":"bf6cff2d-5260-4fde-b015-e974e9505d85","404":"b9837c79-e933-43b0-8e10-d0355652010a","409":"28ab2df5-eb19-4b90-a90b-a6f7a61294e8","422":"d730dfd0-838a-4e74-8ee1-e423b99ac181","429":"2fdf4dd8-27c9-4814-877c-ef970649adf4"},"method":"put","type":"path","servers":["46b27330-8729-49f8-bc01-5b7026690c37"],"path":"/credentials/{credential_id}","baseUrlOptions":["https://api.getdialed.ai/v1"],"title":"Update a credential","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"6e5cb754-95d5-427f-9ba6-5a851ce76825":{"name":"credential_id","in":"path","required":true,"schema":{"type":"string","title":"Credential Id","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"type":"string","title":"Name","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"platform_id":{"type":"string","title":"Platform Id","isRequired":true,"uniqueKey":"platform_id","typeLabel":"string"},"auth_method":{"type":"string","enum":["basic_auth","api_key","jwt","oauth2","aws_access_key"],"title":"Auth Method","isRequired":true,"uniqueKey":"auth_method","typeLabel":"enum\u003cstring>"},"credentials":{"oneOf":[{"type":"object","title":"Credentials","additionalProperties":true,"uniqueKey":"credentials.oneOf.0","typeLabel":"Credentials · object"},{"type":"null","title":"Credentials","uniqueKey":"credentials.oneOf.1","typeLabel":"null"}],"uniqueKey":"credentials","typeLabel":"Credentials · object | null"},"credentials_ref":{"oneOf":[{"type":"string","title":"Credentials Ref","uniqueKey":"credentials_ref.oneOf.0","typeLabel":"string"},{"type":"null","title":"Credentials Ref","uniqueKey":"credentials_ref.oneOf.1","typeLabel":"null"}],"uniqueKey":"credentials_ref","typeLabel":"string | null"},"grant_type":{"oneOf":[{"type":"string","title":"Grant Type","uniqueKey":"grant_type.oneOf.0","typeLabel":"string"},{"type":"null","title":"Grant Type","uniqueKey":"grant_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"grant_type","typeLabel":"string | null"},"token_url":{"oneOf":[{"type":"string","title":"Token Url","uniqueKey":"token_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Token Url","uniqueKey":"token_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"token_url","typeLabel":"string | null"},"scopes":{"items":{"type":"string","uniqueKey":"scopes.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Scopes","uniqueKey":"scopes","typeLabel":"string[]"},"audience":{"oneOf":[{"type":"string","title":"Audience","uniqueKey":"audience.oneOf.0","typeLabel":"string"},{"type":"null","title":"Audience","uniqueKey":"audience.oneOf.1","typeLabel":"null"}],"uniqueKey":"audience","typeLabel":"string | null"},"api_key_placement":{"oneOf":[{"type":"object","title":"ApiKeyPlacement","description":"Where an API-key credential puts its key.\n\nThis is presentation configuration, not secret material: it holds the header\nNAME (and optionally a scheme such as `Bearer` prefixed to the value), or the\nquery-parameter NAME. A form renders straight from it.\n\nIt is declared ONCE, on the credential, so every task that selects this\ncredential injects the key identically and no task configuration ever\nmentions authentication. Exactly one of `header_name` or `query_param` is\nset; `scheme` is legal only alongside `header_name`.","properties":{"header_name":{"oneOf":[{"type":"string","title":"Header Name","uniqueKey":"api_key_placement.oneOf.0.header_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Header Name","uniqueKey":"api_key_placement.oneOf.0.header_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"api_key_placement.oneOf.0.header_name","typeLabel":"string | null"},"scheme":{"oneOf":[{"type":"string","title":"Scheme","uniqueKey":"api_key_placement.oneOf.0.scheme.oneOf.0","typeLabel":"string"},{"type":"null","title":"Scheme","uniqueKey":"api_key_placement.oneOf.0.scheme.oneOf.1","typeLabel":"null"}],"uniqueKey":"api_key_placement.oneOf.0.scheme","typeLabel":"string | null"},"query_param":{"oneOf":[{"type":"string","title":"Query Param","uniqueKey":"api_key_placement.oneOf.0.query_param.oneOf.0","typeLabel":"string"},{"type":"null","title":"Query Param","uniqueKey":"api_key_placement.oneOf.0.query_param.oneOf.1","typeLabel":"null"}],"uniqueKey":"api_key_placement.oneOf.0.query_param","typeLabel":"string | null"}},"uniqueKey":"api_key_placement.oneOf.0","typeLabel":"ApiKeyPlacement · object"},{"type":"null","uniqueKey":"api_key_placement.oneOf.1","typeLabel":"null"}],"uniqueKey":"api_key_placement","typeLabel":"ApiKeyPlacement · object | null"},"aws_region":{"oneOf":[{"type":"string","title":"Aws Region","uniqueKey":"aws_region.oneOf.0","typeLabel":"string"},{"type":"null","title":"Aws Region","uniqueKey":"aws_region.oneOf.1","typeLabel":"null"}],"uniqueKey":"aws_region","typeLabel":"string | null"},"aws_default_bucket":{"oneOf":[{"type":"string","title":"Aws Default Bucket","uniqueKey":"aws_default_bucket.oneOf.0","typeLabel":"string"},{"type":"null","title":"Aws Default Bucket","uniqueKey":"aws_default_bucket.oneOf.1","typeLabel":"null"}],"uniqueKey":"aws_default_bucket","typeLabel":"string | null"},"aws_endpoint_url":{"oneOf":[{"type":"string","title":"Aws Endpoint Url","uniqueKey":"aws_endpoint_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Aws Endpoint Url","uniqueKey":"aws_endpoint_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"aws_endpoint_url","typeLabel":"string | null"},"status":{"type":"string","enum":["active","expired","revoked"],"title":"Status","default":"active","uniqueKey":"status","typeLabel":"enum\u003cstring>"}},"type":"object","required":["name","platform_id","auth_method"],"title":"CredentialUpdate","example":{"auth_method":"basic_auth","credentials":{"password":"REPLACE_ME","username":"api_user@example"},"name":"Five9 Production","platform_id":"five9","status":"active"},"uniqueKey":"","typeLabel":"CredentialUpdate · object"},"examples":{"Example":{"title":"Example","value":{"auth_method":"basic_auth","credentials":{"password":"REPLACE_ME","username":"api_user@example"},"name":"Five9 Production","platform_id":"five9","status":"active"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"37dfab3e-61c4-4cf1-b558-4398c2fa00ae":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"id":{"type":"string","title":"Id","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"org_id":{"type":"string","title":"Org Id","isRequired":true,"uniqueKey":"org_id","typeLabel":"string"},"name":{"type":"string","title":"Name","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"platform_id":{"type":"string","title":"Platform Id","isRequired":true,"uniqueKey":"platform_id","typeLabel":"string"},"auth_method":{"type":"string","title":"Auth Method","isRequired":true,"uniqueKey":"auth_method","typeLabel":"string"},"credentials_ref":{"type":"string","title":"Credentials Ref","isRequired":true,"uniqueKey":"credentials_ref","typeLabel":"string"},"status":{"type":"string","title":"Status","isRequired":true,"uniqueKey":"status","typeLabel":"string"},"created_by":{"type":"string","title":"Created By","isRequired":true,"uniqueKey":"created_by","typeLabel":"string"},"tenancy_id":{"oneOf":[{"type":"string","title":"Tenancy Id","uniqueKey":"tenancy_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Tenancy Id","uniqueKey":"tenancy_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"tenancy_id","typeLabel":"string | null"},"tenant":{"oneOf":[{"type":"object","title":"CredentialTenantSummary","description":"The provider account or customer-named tenant this credential belongs to.","required":["id","label","platform_id","is_manual"],"example":{"id":"ten_1a2b3c4d5e6f7890","is_manual":false,"label":"Acme VCC","platform_id":"five9"},"properties":{"id":{"type":"string","title":"Id","isRequired":true,"uniqueKey":"tenant.oneOf.0.id","typeLabel":"string"},"label":{"type":"string","title":"Label","isRequired":true,"uniqueKey":"tenant.oneOf.0.label","typeLabel":"string"},"platform_id":{"type":"string","title":"Platform Id","isRequired":true,"uniqueKey":"tenant.oneOf.0.platform_id","typeLabel":"string"},"is_manual":{"type":"boolean","title":"Is Manual","isRequired":true,"uniqueKey":"tenant.oneOf.0.is_manual","typeLabel":"boolean"}},"uniqueKey":"tenant.oneOf.0","typeLabel":"CredentialTenantSummary · object"},{"type":"null","uniqueKey":"tenant.oneOf.1","typeLabel":"null"}],"uniqueKey":"tenant","typeLabel":"CredentialTenantSummary · object | null"},"grant_type":{"oneOf":[{"type":"string","title":"Grant Type","uniqueKey":"grant_type.oneOf.0","typeLabel":"string"},{"type":"null","title":"Grant Type","uniqueKey":"grant_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"grant_type","typeLabel":"string | null"},"token_url":{"oneOf":[{"type":"string","title":"Token Url","uniqueKey":"token_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Token Url","uniqueKey":"token_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"token_url","typeLabel":"string | null"},"scopes":{"items":{"type":"string","uniqueKey":"scopes.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Scopes","uniqueKey":"scopes","typeLabel":"string[]"},"audience":{"oneOf":[{"type":"string","title":"Audience","uniqueKey":"audience.oneOf.0","typeLabel":"string"},{"type":"null","title":"Audience","uniqueKey":"audience.oneOf.1","typeLabel":"null"}],"uniqueKey":"audience","typeLabel":"string | null"},"api_key_placement":{"oneOf":[{"type":"object","title":"ApiKeyPlacement","description":"Where an API-key credential puts its key.\n\nThis is presentation configuration, not secret material: it holds the header\nNAME (and optionally a scheme such as `Bearer` prefixed to the value), or the\nquery-parameter NAME. A form renders straight from it.\n\nIt is declared ONCE, on the credential, so every task that selects this\ncredential injects the key identically and no task configuration ever\nmentions authentication. Exactly one of `header_name` or `query_param` is\nset; `scheme` is legal only alongside `header_name`.","properties":{"header_name":{"oneOf":[{"type":"string","title":"Header Name","uniqueKey":"api_key_placement.oneOf.0.header_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Header Name","uniqueKey":"api_key_placement.oneOf.0.header_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"api_key_placement.oneOf.0.header_name","typeLabel":"string | null"},"scheme":{"oneOf":[{"type":"string","title":"Scheme","uniqueKey":"api_key_placement.oneOf.0.scheme.oneOf.0","typeLabel":"string"},{"type":"null","title":"Scheme","uniqueKey":"api_key_placement.oneOf.0.scheme.oneOf.1","typeLabel":"null"}],"uniqueKey":"api_key_placement.oneOf.0.scheme","typeLabel":"string | null"},"query_param":{"oneOf":[{"type":"string","title":"Query Param","uniqueKey":"api_key_placement.oneOf.0.query_param.oneOf.0","typeLabel":"string"},{"type":"null","title":"Query Param","uniqueKey":"api_key_placement.oneOf.0.query_param.oneOf.1","typeLabel":"null"}],"uniqueKey":"api_key_placement.oneOf.0.query_param","typeLabel":"string | null"}},"uniqueKey":"api_key_placement.oneOf.0","typeLabel":"ApiKeyPlacement · object"},{"type":"null","uniqueKey":"api_key_placement.oneOf.1","typeLabel":"null"}],"uniqueKey":"api_key_placement","typeLabel":"ApiKeyPlacement · object | null"},"aws_region":{"oneOf":[{"type":"string","title":"Aws Region","uniqueKey":"aws_region.oneOf.0","typeLabel":"string"},{"type":"null","title":"Aws Region","uniqueKey":"aws_region.oneOf.1","typeLabel":"null"}],"uniqueKey":"aws_region","typeLabel":"string | null"},"aws_default_bucket":{"oneOf":[{"type":"string","title":"Aws Default Bucket","uniqueKey":"aws_default_bucket.oneOf.0","typeLabel":"string"},{"type":"null","title":"Aws Default Bucket","uniqueKey":"aws_default_bucket.oneOf.1","typeLabel":"null"}],"uniqueKey":"aws_default_bucket","typeLabel":"string | null"},"aws_endpoint_url":{"oneOf":[{"type":"string","title":"Aws Endpoint Url","uniqueKey":"aws_endpoint_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Aws Endpoint Url","uniqueKey":"aws_endpoint_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"aws_endpoint_url","typeLabel":"string | null"},"telemetry":{"additionalProperties":{"properties":{"last_used_at":{"oneOf":[{"type":"string","title":"Last Used At","format":"date-time","uniqueKey":"telemetry.additionalProperties.last_used_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Last Used At","uniqueKey":"telemetry.additionalProperties.last_used_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"telemetry.additionalProperties.last_used_at","typeLabel":"string\u003cdate-time> | null"},"last_succeeded_at":{"oneOf":[{"type":"string","title":"Last Succeeded At","format":"date-time","uniqueKey":"telemetry.additionalProperties.last_succeeded_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Last Succeeded At","uniqueKey":"telemetry.additionalProperties.last_succeeded_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"telemetry.additionalProperties.last_succeeded_at","typeLabel":"string\u003cdate-time> | null"},"last_failed_at":{"oneOf":[{"type":"string","title":"Last Failed At","format":"date-time","uniqueKey":"telemetry.additionalProperties.last_failed_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Last Failed At","uniqueKey":"telemetry.additionalProperties.last_failed_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"telemetry.additionalProperties.last_failed_at","typeLabel":"string\u003cdate-time> | null"},"last_error_class":{"oneOf":[{"type":"string","title":"Last Error Class","uniqueKey":"telemetry.additionalProperties.last_error_class.oneOf.0","typeLabel":"string"},{"type":"null","title":"Last Error Class","uniqueKey":"telemetry.additionalProperties.last_error_class.oneOf.1","typeLabel":"null"}],"uniqueKey":"telemetry.additionalProperties.last_error_class","typeLabel":"string | null"},"last_stamped_at":{"oneOf":[{"type":"string","title":"Last Stamped At","format":"date-time","uniqueKey":"telemetry.additionalProperties.last_stamped_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Last Stamped At","uniqueKey":"telemetry.additionalProperties.last_stamped_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"telemetry.additionalProperties.last_stamped_at","typeLabel":"string\u003cdate-time> | null"}},"type":"object","title":"CredentialTelemetrySummary","description":"Observed use of one credential against one service.\n\nRead straight off the credential, so a client can show health without a\nsecond call.","example":{"last_stamped_at":"2026-08-22T09:00:00Z","last_succeeded_at":"2026-08-22T09:00:00Z","last_used_at":"2026-08-22T09:00:00Z"},"uniqueKey":"telemetry.additionalProperties","typeLabel":"CredentialTelemetrySummary · object"},"type":"object","title":"Telemetry","uniqueKey":"telemetry","typeLabel":"Telemetry · object"},"last_verified":{"oneOf":[{"type":"string","title":"Last Verified","format":"date-time","uniqueKey":"last_verified.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Last Verified","uniqueKey":"last_verified.oneOf.1","typeLabel":"null"}],"uniqueKey":"last_verified","typeLabel":"string\u003cdate-time> | null"},"created_at":{"oneOf":[{"type":"string","title":"Created At","format":"date-time","uniqueKey":"created_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Created At","uniqueKey":"created_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"created_at","typeLabel":"string\u003cdate-time> | null"}},"type":"object","required":["id","org_id","name","platform_id","auth_method","credentials_ref","status","created_by"],"title":"CredentialResponse","example":{"auth_method":"basic_auth","created_at":"2026-08-01T12:00:00Z","created_by":"user_11223344","credentials_ref":"getdialed/acme/five9/cred_e5f6g7h8","id":"cred_e5f6g7h8","last_verified":"2026-08-22T09:00:00Z","name":"Five9 Production","org_id":"org_a1b2c3d4","platform_id":"five9","scopes":[],"status":"active","telemetry":{"five9__configuration_service":{"last_stamped_at":"2026-08-22T09:00:00Z","last_succeeded_at":"2026-08-22T09:00:00Z","last_used_at":"2026-08-22T09:00:00Z"}},"tenancy_id":"ten_1a2b3c4d5e6f7890","tenant":{"id":"ten_1a2b3c4d5e6f7890","is_manual":false,"label":"Acme VCC","platform_id":"five9"}},"uniqueKey":"","typeLabel":"CredentialResponse · object"},"examples":{"Example":{"title":"Example","value":{"auth_method":"basic_auth","created_at":"2026-08-01T12:00:00Z","created_by":"user_11223344","credentials_ref":"getdialed/acme/five9/cred_e5f6g7h8","id":"cred_e5f6g7h8","last_verified":"2026-08-22T09:00:00Z","name":"Five9 Production","org_id":"org_a1b2c3d4","platform_id":"five9","scopes":[],"status":"active","telemetry":{"five9__configuration_service":{"last_stamped_at":"2026-08-22T09:00:00Z","last_succeeded_at":"2026-08-22T09:00:00Z","last_used_at":"2026-08-22T09:00:00Z"}},"tenancy_id":"ten_1a2b3c4d5e6f7890","tenant":{"id":"ten_1a2b3c4d5e6f7890","is_manual":false,"label":"Acme VCC","platform_id":"five9"}}}},"exampleType":"generated"}},"exampleType":"generated"},"c23b4330-2221-46f6-8a94-879a85b8fc3b":{"description":"The update tries to move the credential to a different platform, which would orphan its provider-account binding","content":{"application/json":{"example":{"detail":"platform_id cannot be changed on an existing credential. The stored provider account, the credential's identity and the shape of the stored secret all belong to one platform. Create a credential for the other platform instead."},"examples":{"Example":{"title":"Example","value":{"detail":"platform_id cannot be changed on an existing credential. The stored provider account, the credential's identity and the shape of the stored secret all belong to one platform. Create a credential for the other platform instead."}}},"exampleType":"examples"}},"exampleType":"examples"},"5fd8d767-6b5a-4467-88df-289daacc115f":{"description":"Missing or invalid authentication","content":{"application/json":{"example":{"detail":"Authentication required"},"examples":{"Example":{"title":"Example","value":{"detail":"Authentication required"}}},"exampleType":"examples"}},"exampleType":"examples"},"bf6cff2d-5260-4fde-b015-e974e9505d85":{"description":"Caller is authenticated but not an admin","content":{"application/json":{"example":{"detail":"Admin role required"},"examples":{"Example":{"title":"Example","value":{"detail":"Admin role required"}}},"exampleType":"examples"}},"exampleType":"examples"},"b9837c79-e933-43b0-8e10-d0355652010a":{"description":"No such credential for this organization (cross-tenant access also returns 404)","content":{"application/json":{"example":{"detail":"Credential not found"},"examples":{"Example":{"title":"Example","value":{"detail":"Credential not found"}}},"exampleType":"examples"}},"exampleType":"examples"},"28ab2df5-eb19-4b90-a90b-a6f7a61294e8":{"description":"The rotation's new material resolves to a different provider identity or tenant than the stored binding describes, so the rotation is refused rather than silently rebound","content":{"application/json":{"example":{"detail":"The new material belongs to a different provider account or identity than this credential is bound to. Create a separate credential for it instead of rotating this one."},"examples":{"Example":{"title":"Example","value":{"detail":"The new material belongs to a different provider account or identity than this credential is bound to. Create a separate credential for it instead of rotating this one."}}},"exampleType":"examples"}},"exampleType":"examples"},"d730dfd0-838a-4e74-8ee1-e423b99ac181":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"},"input":{"oneOf":[{"title":"Input"}],"uniqueKey":"detail.items.[INDEX].input","typeLabel":"any"},"ctx":{"type":"object","title":"Context","uniqueKey":"detail.items.[INDEX].ctx","typeLabel":"Context · object"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>","input":"\u003cunknown>","ctx":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"},"2fdf4dd8-27c9-4814-877c-ef970649adf4":{"description":"Rate limit exceeded — retry after the Retry-After header","headers":{"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer"}}},"content":{"application/json":{"example":{"detail":"Rate limit exceeded: 100 per 1 minute"},"examples":{"Example":{"title":"Example","value":{"detail":"Rate limit exceeded: 100 per 1 minute"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"3c0ed92d-da35-4a10-b58b-9b9db2dbd23c":{"APIKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key","scopes":[],"schemeName":"APIKeyHeader"}},"7a94cd3e-640e-4606-a636-3c2ce84caf3c":{"HTTPBearer":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"HTTPBearer"}}},"servers":{"46b27330-8729-49f8-bc01-5b7026690c37":{"url":"https://api.getdialed.ai/v1","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","scopes":[],"schemeName":"APIKeyHeader"},"schema":{"title":"X-API-Key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"APIKeyHeader","name":"X-API-Key"}],"title":"APIKeyHeader"},{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"HTTPBearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"HTTPBearer","name":"Authorization"}],"title":"HTTPBearer"}]},"originalFileLocation":"openapi.json"},"subdomain":"getdialed","siteName":"GetDialed Docs","title":"Update a credential - GetDialed Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-22T15:46:44.080Z","originalFileLocation":"api-reference/credentials/update-a-credential.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Update a credential\u0026#x27;s name, status and authentication configuration. Admin only. Supply credentials to ROTATE the stored secret. The new material replaces the old in place: the credential keeps its id and keeps pointing at the same stored secret, so every flow that uses this credential picks the new material up with no flow edit, no re-selection and no redeployment. Running workers refresh their cached copy within five minutes. Rotating an OAuth2 credential also clears its cached access token, so the next run fetches a fresh token with the new material. Tokens the provider has already issued are not revoked here and remain valid until they expire on the provider\u0026#x27;s own schedule. Rotation keeps the credential\u0026#x27;s provider-account binding, so the new material must belong to the same provider account and identity as the old. When the platform can identify the account credentials belong to, the new material is verified against it during the rotation: material that resolves to a different account or identity is refused with a 409 — create a separate credential for it instead. Rotating clears the credential\u0026#x27;s last verification time, because the recorded check described the previous material. Run a test to record a fresh one. platform_id must match the stored value — a credential belongs to one platform for its whole life. Server-managed fields (the provider account binding, the stored-secret pointer, the observed-use record) cannot be set from a request body and are preserved. Cross-tenant access returns 404.\">\u003cmeta data-mint-head name=\"application-name\" content=\"GetDialed Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/getdialed/W4q54Y-ijV9_76KA/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/getdialed/W4q54Y-ijV9_76KA/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/getdialed/W4q54Y-ijV9_76KA/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/getdialed/W4q54Y-ijV9_76KA/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/getdialed/W4q54Y-ijV9_76KA/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/getdialed/W4q54Y-ijV9_76KA/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/getdialed/W4q54Y-ijV9_76KA/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/getdialed/W4q54Y-ijV9_76KA/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/getdialed/W4q54Y-ijV9_76KA/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update a credential - GetDialed Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Update a credential\u0026#x27;s name, status and authentication configuration. Admin only. Supply credentials to ROTATE the stored secret. The new material replaces the old in place: the credential keeps its id and keeps pointing at the same stored secret, so every flow that uses this credential picks the new material up with no flow edit, no re-selection and no redeployment. Running workers refresh their cached copy within five minutes. Rotating an OAuth2 credential also clears its cached access token, so the next run fetches a fresh token with the new material. Tokens the provider has already issued are not revoked here and remain valid until they expire on the provider\u0026#x27;s own schedule. Rotation keeps the credential\u0026#x27;s provider-account binding, so the new material must belong to the same provider account and identity as the old. When the platform can identify the account credentials belong to, the new material is verified against it during the rotation: material that resolves to a different account or identity is refused with a 409 — create a separate credential for it instead. Rotating clears the credential\u0026#x27;s last verification time, because the recorded check described the previous material. Run a test to record a fresh one. platform_id must match the stored value — a credential belongs to one platform for its whole life. Server-managed fields (the provider account binding, the stored-secret pointer, the observed-use record) cannot be set from a request body and are preserved. Cross-tenant access returns 404.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"GetDialed Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.getdialed.ai/api-reference/credentials/update-a-credential\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://getdialed.mintlify.app/_mintlify/api/og/v2?division=Credentials+%E2%80%94+%2Fv1%2Fcredentials\u0026amp;title=Update+a+credential\u0026amp;description=Update+a+credential%27s+name%2C+status+and+authentication+configuration.+Admin+only.%0A%0ASupply+%60credentials%60+to+ROTATE+the+stored+secret.+The+new+material+replaces+th\u0026amp;theme=b6a8f417cb6da704c51ca7d7\u0026amp;signature=52001e0f8f1f61f950d3d5ce40597f94912d9abfeea03108a41d006c4b3e015a\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Update a credential - GetDialed Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Update a credential\u0026#x27;s name, status and authentication configuration. Admin only. Supply credentials to ROTATE the stored secret. The new material replaces the old in place: the credential keeps its id and keeps pointing at the same stored secret, so every flow that uses this credential picks the new material up with no flow edit, no re-selection and no redeployment. Running workers refresh their cached copy within five minutes. Rotating an OAuth2 credential also clears its cached access token, so the next run fetches a fresh token with the new material. Tokens the provider has already issued are not revoked here and remain valid until they expire on the provider\u0026#x27;s own schedule. Rotation keeps the credential\u0026#x27;s provider-account binding, so the new material must belong to the same provider account and identity as the old. When the platform can identify the account credentials belong to, the new material is verified against it during the rotation: material that resolves to a different account or identity is refused with a 409 — create a separate credential for it instead. Rotating clears the credential\u0026#x27;s last verification time, because the recorded check described the previous material. Run a test to record a fresh one. platform_id must match the stored value — a credential belongs to one platform for its whole life. Server-managed fields (the provider account binding, the stored-secret pointer, the observed-use record) cannot be set from a request body and are preserved. Cross-tenant access returns 404.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://getdialed.mintlify.app/_mintlify/api/og/v2?division=Credentials+%E2%80%94+%2Fv1%2Fcredentials\u0026amp;title=Update+a+credential\u0026amp;description=Update+a+credential%27s+name%2C+status+and+authentication+configuration.+Admin+only.%0A%0ASupply+%60credentials%60+to+ROTATE+the+stored+secret.+The+new+material+replaces+th\u0026amp;theme=b6a8f417cb6da704c51ca7d7\u0026amp;signature=52001e0f8f1f61f950d3d5ce40597f94912d9abfeea03108a41d006c4b3e015a\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/getdialed/W4q54Y-ijV9_76KA/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"GetDialed Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4F46E5\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.getdialed.ai/api-reference/credentials/update-a-credential\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/credentials/update-a-credential.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.getdialed.ai/#organization\",\"name\":\"GetDialed Docs\",\"url\":\"https://docs.getdialed.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/getdialed/aL0yqdSUKnvM2urY/logo/light.svg?fit=max\u0026auto=format\u0026n=aL0yqdSUKnvM2urY\u0026q=85\u0026s=f6bd462ed94234572b2ef5546432f2e6\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.getdialed.ai#website\",\"name\":\"GetDialed Docs\",\"url\":\"https://docs.getdialed.ai\",\"publisher\":{\"@id\":\"https://docs.getdialed.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.getdialed.ai/api-reference/credentials/update-a-credential#webpage\",\"url\":\"https://docs.getdialed.ai/api-reference/credentials/update-a-credential\",\"name\":\"Update a credential\",\"description\":\"Update a credential's name, status and authentication configuration. Admin only. Supply credentials to ROTATE the stored secret. The new material replaces the old in place: the credential keeps its id and keeps pointing at the same stored secret, so every flow that uses this credential picks the new material up with no flow edit, no re-selection and no redeployment. Running workers refresh their cached copy within five minutes. Rotating an OAuth2 credential also clears its cached access token, so the next run fetches a fresh token with the new material. Tokens the provider has already issued are not revoked here and remain valid until they expire on the provider's own schedule. Rotation keeps the credential's provider-account binding, so the new material must belong to the same provider account and identity as the old. When the platform can identify the account credentials belong to, the new material is verified against it during the rotation: material that resolves to a different account or identity is refused with a 409 — create a separate credential for it instead. Rotating clears the credential's last verification time, because the recorded check described the previous material. Run a test to record a fresh one. platform_id must match the stored value — a credential belongs to one platform for its whole life. Server-managed fields (the provider account binding, the stored-secret pointer, the observed-use record) cannot be set from a request body and are preserved. Cross-tenant access returns 404.\",\"dateModified\":\"2026-10-22T15:46:44.080Z\",\"isPartOf\":{\"@id\":\"https://docs.getdialed.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.getdialed.ai/api-reference/credentials/update-a-credential#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.getdialed.ai/api-reference/credentials/update-a-credential#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Credentials — /v1/credentials\",\"item\":\"https://docs.getdialed.ai/api-reference/credentials/list-credentials\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Update a credential\",\"item\":\"https://docs.getdialed.ai/api-reference/credentials/update-a-credential\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.getdialed.ai/api-reference/credentials/update-a-credential#apireference\",\"headline\":\"Update a credential\",\"name\":\"Update a credential\",\"description\":\"Update a credential's name, status and authentication configuration. Admin only. Supply credentials to ROTATE the stored secret. The new material replaces the old in place: the credential keeps its id and keeps pointing at the same stored secret, so every flow that uses this credential picks the new material up with no flow edit, no re-selection and no redeployment. Running workers refresh their cached copy within five minutes. Rotating an OAuth2 credential also clears its cached access token, so the next run fetches a fresh token with the new material. Tokens the provider has already issued are not revoked here and remain valid until they expire on the provider's own schedule. Rotation keeps the credential's provider-account binding, so the new material must belong to the same provider account and identity as the old. When the platform can identify the account credentials belong to, the new material is verified against it during the rotation: material that resolves to a different account or identity is refused with a 409 — create a separate credential for it instead. Rotating clears the credential's last verification time, because the recorded check described the previous material. Run a test to record a fresh one. platform_id must match the stored value — a credential belongs to one platform for its whole life. Server-managed fields (the provider account binding, the stored-secret pointer, the observed-use record) cannot be set from a request body and are preserved. Cross-tenant access returns 404.\",\"url\":\"https://docs.getdialed.ai/api-reference/credentials/update-a-credential\",\"mainEntityOfPage\":{\"@id\":\"https://docs.getdialed.ai/api-reference/credentials/update-a-credential#webpage\"},\"dateModified\":\"2026-10-22T15:46:44.080Z\",\"publisher\":{\"@id\":\"https://docs.getdialed.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.getdialed.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"GetDialed Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"GetDialed Docs","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API introduction","href":"/api-reference/introduction"},{"title":"Dispatch pause \u0026 resume","href":"/api-reference/dispatch-pause"},{"title":"Change a batch's priority or pacing","href":"/api-reference/batch-patch"}]},{"group":"Flows — /v1/flows","pages":[{"group":"Definitions","pages":[{"title":"List definitions","deprecated":null,"version":null,"openapi":"/openapi.json get /flows/definitions","href":"/api-reference/definitions/list-definitions"},{"title":"Create a definition","deprecated":null,"version":null,"openapi":"/openapi.json post /flows/definitions","href":"/api-reference/definitions/create-a-definition"},{"title":"Get a definition","deprecated":null,"version":null,"openapi":"/openapi.json get /flows/definitions/{definition_id}","href":"/api-reference/definitions/get-a-definition"},{"title":"Update a definition","deprecated":null,"version":null,"openapi":"/openapi.json put /flows/definitions/{definition_id}","href":"/api-reference/definitions/update-a-definition"},{"title":"Delete a definition","deprecated":null,"version":null,"openapi":"/openapi.json delete /flows/definitions/{definition_id}","href":"/api-reference/definitions/delete-a-definition"},{"title":"Trigger a definition","deprecated":null,"version":null,"openapi":"/openapi.json post /flows/definitions/{definition_id}/trigger","href":"/api-reference/definitions/trigger-a-definition"},{"title":"List batches for a definition","deprecated":null,"version":null,"openapi":"/openapi.json get /flows/definitions/{definition_id}/batches","href":"/api-reference/batches/list-batches-for-a-definition"}]},{"group":"Templates","pages":[{"title":"List templates","deprecated":null,"version":null,"openapi":"/openapi.json get /flows/templates","href":"/api-reference/templates/list-templates"},{"title":"Get a template","deprecated":null,"version":null,"openapi":"/openapi.json get /flows/templates/{template_id}","href":"/api-reference/templates/get-a-template"}]},{"group":"Schedules","pages":[{"title":"List schedules","deprecated":null,"version":null,"openapi":"/openapi.json get /flows/schedules","href":"/api-reference/schedules/list-schedules"},{"title":"Create a schedule","deprecated":null,"version":null,"openapi":"/openapi.json post /flows/schedules","href":"/api-reference/schedules/create-a-schedule"},{"title":"Get a schedule","deprecated":null,"version":null,"openapi":"/openapi.json get /flows/schedules/{sched_id}","href":"/api-reference/schedules/get-a-schedule"},{"title":"Update a schedule","deprecated":null,"version":null,"openapi":"/openapi.json patch /flows/schedules/{sched_id}","href":"/api-reference/schedules/update-a-schedule"},{"title":"Delete a schedule","deprecated":null,"version":null,"openapi":"/openapi.json delete /flows/schedules/{sched_id}","href":"/api-reference/schedules/delete-a-schedule"}]},{"group":"Triggers","pages":[{"title":"List triggers","deprecated":null,"version":null,"openapi":"/openapi.json get /flows/triggers","href":"/api-reference/triggers/list-triggers"},{"title":"Get a trigger","deprecated":null,"version":null,"openapi":"/openapi.json get /flows/triggers/{trigger_id}","href":"/api-reference/triggers/get-a-trigger"},{"title":"List the batches a trigger spawned","deprecated":null,"version":null,"openapi":"/openapi.json get /flows/triggers/{trigger_id}/batches","href":"/api-reference/triggers/list-the-batches-a-trigger-spawned"}]},{"group":"Webhooks","pages":[{"title":"List webhooks","deprecated":null,"version":null,"openapi":"/openapi.json get /flows/webhooks","href":"/api-reference/webhooks/list-webhooks"},{"title":"Create a webhook","deprecated":null,"version":null,"openapi":"/openapi.json post /flows/webhooks","href":"/api-reference/webhooks/create-a-webhook"},{"title":"Get a webhook","deprecated":null,"version":null,"openapi":"/openapi.json get /flows/webhooks/{webhook_id}","href":"/api-reference/webhooks/get-a-webhook"},{"title":"Update a webhook","deprecated":null,"version":null,"openapi":"/openapi.json patch /flows/webhooks/{webhook_id}","href":"/api-reference/webhooks/update-a-webhook"},{"title":"Delete a webhook","deprecated":null,"version":null,"openapi":"/openapi.json delete /flows/webhooks/{webhook_id}","href":"/api-reference/webhooks/delete-a-webhook"},{"title":"Rotate a webhook signing secret","deprecated":null,"version":null,"openapi":"/openapi.json post /flows/webhooks/{webhook_id}/rotate-secret","href":"/api-reference/webhooks/rotate-a-webhook-signing-secret"},{"title":"List webhook deliveries","deprecated":null,"version":null,"openapi":"/openapi.json get /flows/webhooks/{webhook_id}/deliveries","href":"/api-reference/webhooks/list-webhook-deliveries"},{"title":"Receive a webhook (called by your external system)","deprecated":null,"version":null,"openapi":"/openapi.json post /flows/webhooks/{slug}/{webhook_id}","href":"/api-reference/webhooks/receive-a-webhook-called-by-your-external-system"},{"title":"Five9 import callback (called by Five9, not by you)","deprecated":null,"version":null,"openapi":"/openapi.json post /flows/webhooks/five9-import/{slug}/{token}","href":"/api-reference/webhooks/five9-import-callback-called-by-five9-not-by-you"}]},{"group":"Event Subscriptions","pages":[{"title":"List event subscriptions","deprecated":null,"version":null,"openapi":"/openapi.json get /flows/event-subscriptions","href":"/api-reference/event-subscriptions/list-event-subscriptions"},{"title":"Create an event subscription","deprecated":null,"version":null,"openapi":"/openapi.json post /flows/event-subscriptions","href":"/api-reference/event-subscriptions/create-an-event-subscription"},{"title":"Get an event subscription","deprecated":null,"version":null,"openapi":"/openapi.json get /flows/event-subscriptions/{sub_id}","href":"/api-reference/event-subscriptions/get-an-event-subscription"},{"title":"Delete an event subscription","deprecated":null,"version":null,"openapi":"/openapi.json delete /flows/event-subscriptions/{sub_id}","href":"/api-reference/event-subscriptions/delete-an-event-subscription"}]},{"group":"Batches","pages":[{"title":"List account-wide batches","deprecated":null,"version":null,"openapi":"/openapi.json get /flows/batches","href":"/api-reference/batches/list-account-wide-batches"},{"title":"Get a batch","deprecated":null,"version":null,"openapi":"/openapi.json get /flows/batches/{batch_id}","href":"/api-reference/batches/get-a-batch"},{"title":"Change a batch's priority or pacing","deprecated":null,"version":null,"openapi":"/openapi.json patch /flows/batches/{batch_id}","href":"/api-reference/batches/change-a-batchs-priority-or-pacing"},{"title":"Cancel a batch","deprecated":null,"version":null,"openapi":"/openapi.json post /flows/batches/{batch_id}/cancel","href":"/api-reference/batches/cancel-a-batch"},{"title":"Cancel a batch (deprecated)","deprecated":true,"version":null,"openapi":"/openapi.json delete /flows/batches/{batch_id}","href":"/api-reference/batches/cancel-a-batch-deprecated"},{"title":"Pause dispatch for a batch","deprecated":null,"version":null,"openapi":"/openapi.json post /flows/batches/{batch_id}/pause","href":"/api-reference/batches/pause-dispatch-for-a-batch"},{"title":"Resume dispatch for a batch","deprecated":null,"version":null,"openapi":"/openapi.json post /flows/batches/{batch_id}/resume","href":"/api-reference/batches/resume-dispatch-for-a-batch"},{"title":"Requeue a batch's held work","deprecated":null,"version":null,"openapi":"/openapi.json post /flows/batches/{batch_id}/requeue","href":"/api-reference/batches/requeue-a-batchs-held-work"},{"title":"List executions for a batch","deprecated":null,"version":null,"openapi":"/openapi.json get /flows/batches/{batch_id}/executions","href":"/api-reference/executions/list-executions-for-a-batch"},{"title":"Stream batch events (SSE)","deprecated":null,"version":null,"openapi":"/openapi.json get /flows/batches/{batch_id}/stream","href":"/api-reference/streams/stream-batch-events-sse"}]},{"group":"Executions","pages":[{"title":"Get an execution","deprecated":null,"version":null,"openapi":"/openapi.json get /flows/executions/{execution_id}","href":"/api-reference/executions/get-an-execution"},{"title":"Stream execution events (SSE)","deprecated":null,"version":null,"openapi":"/openapi.json get /flows/executions/{execution_id}/stream","href":"/api-reference/streams/stream-execution-events-sse"}]},{"group":"Jobs \u0026 Exports","pages":[{"title":"List account-wide jobs","deprecated":null,"version":null,"openapi":"/openapi.json get /flows/jobs","href":"/api-reference/jobs/list-account-wide-jobs"},{"title":"Get a job","deprecated":null,"version":null,"openapi":"/openapi.json get /flows/jobs/{job_id}","href":"/api-reference/jobs/get-a-job"},{"title":"Request a CSV export of your jobs","deprecated":null,"version":null,"openapi":"/openapi.json post /flows/jobs/export","href":"/api-reference/jobs/request-a-csv-export-of-your-jobs"},{"title":"Get an export and its download URL","deprecated":null,"version":null,"openapi":"/openapi.json get /flows/jobs/exports/{export_id}","href":"/api-reference/jobs/get-an-export-and-its-download-url"}]},{"group":"Variables","pages":[{"title":"List variable sets","deprecated":null,"version":null,"openapi":"/openapi.json get /flows/variables","href":"/api-reference/variables/list-variable-sets"},{"title":"Create a variable set","deprecated":null,"version":null,"openapi":"/openapi.json post /flows/variables","href":"/api-reference/variables/create-a-variable-set"},{"title":"Get a variable set","deprecated":null,"version":null,"openapi":"/openapi.json get /flows/variables/{set_name}","href":"/api-reference/variables/get-a-variable-set"},{"title":"Update or rename a variable set","deprecated":null,"version":null,"openapi":"/openapi.json put /flows/variables/{set_name}","href":"/api-reference/variables/update-or-rename-a-variable-set"},{"title":"Delete a variable set","deprecated":null,"version":null,"openapi":"/openapi.json delete /flows/variables/{set_name}","href":"/api-reference/variables/delete-a-variable-set"},{"title":"Add a version to a set","deprecated":null,"version":null,"openapi":"/openapi.json post /flows/variables/{set_name}/versions","href":"/api-reference/variables/add-a-version-to-a-set"},{"title":"Update or rename a version","deprecated":null,"version":null,"openapi":"/openapi.json put /flows/variables/{set_name}/versions/{version_name}","href":"/api-reference/variables/update-or-rename-a-version"},{"title":"Delete a version","deprecated":null,"version":null,"openapi":"/openapi.json delete /flows/variables/{set_name}/versions/{version_name}","href":"/api-reference/variables/delete-a-version"}]},{"group":"Dashboard \u0026 Usage","pages":[{"title":"Get the dashboard summary","deprecated":null,"version":null,"openapi":"/openapi.json get /flows/dashboard/summary","href":"/api-reference/dashboard/get-the-dashboard-summary"},{"title":"Get usage analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /flows/usage","href":"/api-reference/usage/get-usage-analytics"}]}]},{"group":"Account — /v1/account","pages":[{"title":"Get current session context","deprecated":null,"version":null,"openapi":"/openapi.json get /account/me","href":"/api-reference/me/get-current-session-context"},{"title":"List API keys","deprecated":null,"version":null,"openapi":"/openapi.json get /account/api-keys","href":"/api-reference/api-keys/list-api-keys"},{"title":"Create an API key","deprecated":null,"version":null,"openapi":"/openapi.json post /account/api-keys","href":"/api-reference/api-keys/create-an-api-key"},{"title":"Revoke an API key","deprecated":null,"version":null,"openapi":"/openapi.json delete /account/api-keys/{key_id}","href":"/api-reference/api-keys/revoke-an-api-key"},{"title":"Mint a stream token","deprecated":null,"version":null,"openapi":"/openapi.json post /account/auth/stream-token","href":"/api-reference/auth/mint-a-stream-token"}]},{"group":"Data — /v1/data","pages":[{"title":"Create a record set","deprecated":null,"version":null,"openapi":"/openapi.json post /data/record-sets","href":"/api-reference/record-sets/create-a-record-set"},{"title":"Get a record set","deprecated":null,"version":null,"openapi":"/openapi.json get /data/record-sets/{record_set_id}","href":"/api-reference/record-sets/get-a-record-set"},{"title":"Upload one chunk of records","deprecated":null,"version":null,"openapi":"/openapi.json post /data/record-sets/{record_set_id}/records","href":"/api-reference/record-sets/upload-one-chunk-of-records"},{"title":"Seal a record set","deprecated":null,"version":null,"openapi":"/openapi.json post /data/record-sets/{record_set_id}/seal","href":"/api-reference/record-sets/seal-a-record-set"},{"title":"List data stores","deprecated":null,"version":null,"openapi":"/openapi.json get /data/stores","href":"/api-reference/data-stores/list-data-stores"},{"title":"Get a data store","deprecated":null,"version":null,"openapi":"/openapi.json get /data/stores/{store}","href":"/api-reference/data-stores/get-a-data-store"},{"title":"List store records","deprecated":null,"version":null,"openapi":"/openapi.json get /data/stores/{store}/records","href":"/api-reference/data-stores/list-store-records"},{"title":"Get a store record","deprecated":null,"version":null,"openapi":"/openapi.json get /data/stores/{store}/records/{key}","href":"/api-reference/data-stores/get-a-store-record"},{"title":"Edit a store record","deprecated":null,"version":null,"openapi":"/openapi.json patch /data/stores/{store}/records/{key}","href":"/api-reference/data-stores/edit-a-store-record"},{"title":"Get a store record's history","deprecated":null,"version":null,"openapi":"/openapi.json get /data/stores/{store}/records/{key}/history","href":"/api-reference/data-stores/get-a-store-records-history"},{"title":"Get a store's precedence settings","deprecated":null,"version":null,"openapi":"/openapi.json get /data/stores/{store}/precedence","href":"/api-reference/data-stores/get-a-stores-precedence-settings"},{"title":"Set a store's precedence settings","deprecated":null,"version":null,"openapi":"/openapi.json put /data/stores/{store}/precedence","href":"/api-reference/data-stores/set-a-stores-precedence-settings"},{"title":"Reset a store's precedence settings","deprecated":null,"version":null,"openapi":"/openapi.json delete /data/stores/{store}/precedence","href":"/api-reference/data-stores/reset-a-stores-precedence-settings"}]},{"group":"Catalog — /v1/catalog","pages":[{"title":"List platforms","deprecated":null,"version":null,"openapi":"/openapi.json get /catalog/platforms","href":"/api-reference/catalog/list-platforms"},{"title":"Get a platform","deprecated":null,"version":null,"openapi":"/openapi.json get /catalog/platforms/{platform_id}","href":"/api-reference/catalog/get-a-platform"},{"title":"List services for a platform","deprecated":null,"version":null,"openapi":"/openapi.json get /catalog/platforms/{platform_id}/services","href":"/api-reference/catalog/list-services-for-a-platform"},{"title":"Get a service","deprecated":null,"version":null,"openapi":"/openapi.json get /catalog/services/{service_id}","href":"/api-reference/catalog/get-a-service"},{"title":"List actions for a service","deprecated":null,"version":null,"openapi":"/openapi.json get /catalog/services/{service_id}/actions","href":"/api-reference/catalog/list-actions-for-a-service"},{"title":"Get an action","deprecated":null,"version":null,"openapi":"/openapi.json get /catalog/actions/{action_id}","href":"/api-reference/catalog/get-an-action"}]},{"group":"Credentials — /v1/credentials","pages":[{"title":"List credentials","deprecated":null,"version":null,"openapi":"/openapi.json get /credentials","href":"/api-reference/credentials/list-credentials"},{"title":"Create a credential","deprecated":null,"version":null,"openapi":"/openapi.json post /credentials","href":"/api-reference/credentials/create-a-credential"},{"title":"Get a credential","description":"Fetch a single credential by id, including its provider-account label and its observed-use record.\n\nThe observed-use record is the honest answer to \"what can this credential do\". For every service the credential has been used with it reports when it was last used, when it last succeeded, when it last failed and what class of failure that was — recorded as the work actually happened. Read it here to see a credential's real capabilities and health without running a flow to find out, and without a second request per row: the same record travels on every row of `GET /credentials`.\n\nCross-tenant access returns 404.","deprecated":null,"version":null,"openapi":"/openapi.json get /credentials/{credential_id}","href":"/api-reference/credentials/get-a-credential"},{"title":"Update a credential","deprecated":null,"version":null,"openapi":"/openapi.json put /credentials/{credential_id}","href":"/api-reference/credentials/update-a-credential"},{"title":"Delete a credential","description":"Delete a credential and the secret it stores. Admin only.\n\nReturns 409 when the stored secret is still used by other credentials in this account: one secret can serve several credentials, so deleting one of them must not take the others down. The record is left intact, so the delete can be retried once the other references are detached.\n\nA secret this API did not create is never destroyed — the credential record is removed and the secret is left for whoever provisioned it. A secret that IS destroyed keeps a recovery window. Deleting the last credential bound to a provider account frees that account, so any organization may then connect it. Cross-tenant access returns 404.","deprecated":null,"version":null,"openapi":"/openapi.json delete /credentials/{credential_id}","href":"/api-reference/credentials/delete-a-credential"},{"title":"Test credentials without saving them","deprecated":null,"version":null,"openapi":"/openapi.json post /credentials/test","href":"/api-reference/credentials/test-credentials-without-saving-them"},{"title":"Test a saved credential","deprecated":null,"version":null,"openapi":"/openapi.json post /credentials/{credential_id}/test","href":"/api-reference/credentials/test-a-saved-credential"}]},{"group":"Tenants — /v1/tenants","pages":[{"title":"List tenants","deprecated":null,"version":null,"openapi":"/openapi.json get /tenants","href":"/api-reference/tenants/list-tenants"},{"title":"Get a tenant","deprecated":null,"version":null,"openapi":"/openapi.json get /tenants/{tenancy_id}","href":"/api-reference/tenants/get-a-tenant"},{"title":"Rename a tenant","deprecated":null,"version":null,"openapi":"/openapi.json patch /tenants/{tenancy_id}","href":"/api-reference/tenants/rename-a-tenant"},{"title":"Retire a tenant","deprecated":null,"version":null,"openapi":"/openapi.json delete /tenants/{tenancy_id}","href":"/api-reference/tenants/retire-a-tenant"}]},{"group":"Five9 Domains — /v1/platforms/five9","pages":[{"title":"List Five9 Domains","deprecated":null,"version":null,"openapi":"/openapi.json get /platforms/five9/domains","href":"/api-reference/five9-domains/list-five9-domains"},{"title":"Get a Five9 Domain","deprecated":null,"version":null,"openapi":"/openapi.json get /platforms/five9/domains/{tenancy_id}","href":"/api-reference/five9-domains/get-a-five9-domain"},{"title":"Update a Five9 Domain's margins and lanes","deprecated":null,"version":null,"openapi":"/openapi.json patch /platforms/five9/domains/{tenancy_id}","href":"/api-reference/five9-domains/update-a-five9-domains-margins-and-lanes"},{"title":"Read a Domain's remaining budget per bucket","deprecated":null,"version":null,"openapi":"/openapi.json get /platforms/five9/domains/{tenancy_id}/headroom","href":"/api-reference/five9-domains/read-a-domains-remaining-budget-per-bucket"},{"title":"Read a Domain's queue depth and estimated completion","deprecated":null,"version":null,"openapi":"/openapi.json get /platforms/five9/domains/{tenancy_id}/queue","href":"/api-reference/five9-domains/read-a-domains-queue-depth-and-estimated-completion"},{"title":"Read a Domain's recent rate-limit usage history","deprecated":null,"version":null,"openapi":"/openapi.json get /platforms/five9/domains/{tenancy_id}/usage","href":"/api-reference/five9-domains/read-a-domains-recent-rate-limit-usage-history"},{"title":"Read per-credential budget attribution for a Domain","deprecated":null,"version":null,"openapi":"/openapi.json get /platforms/five9/domains/{tenancy_id}/attribution","href":"/api-reference/five9-domains/read-per-credential-budget-attribution-for-a-domain"},{"title":"Estimate what an upload will cost against a Domain's budget","deprecated":null,"version":null,"openapi":"/openapi.json post /platforms/five9/domains/{tenancy_id}/estimate","href":"/api-reference/five9-domains/estimate-what-an-upload-will-cost-against-a-domains-budget"},{"title":"Refresh a Five9 Domain's live limits","deprecated":null,"version":null,"openapi":"/openapi.json post /platforms/five9/domains/{tenancy_id}/refresh-limits","href":"/api-reference/five9-domains/refresh-a-five9-domains-live-limits"},{"title":"Pause dispatch for a Five9 Domain","deprecated":null,"version":null,"openapi":"/openapi.json post /platforms/five9/domains/{tenancy_id}/pause","href":"/api-reference/five9-domains/pause-dispatch-for-a-five9-domain"},{"title":"Resume dispatch for a Five9 Domain","deprecated":null,"version":null,"openapi":"/openapi.json post /platforms/five9/domains/{tenancy_id}/resume","href":"/api-reference/five9-domains/resume-dispatch-for-a-five9-domain"},{"title":"List everything holding this Domain's dispatch","deprecated":null,"version":null,"openapi":"/openapi.json get /platforms/five9/domains/{tenancy_id}/pauses","href":"/api-reference/five9-domains/list-everything-holding-this-domains-dispatch"},{"title":"Extend a Domain pause's scheduled resume","deprecated":null,"version":null,"openapi":"/openapi.json patch /platforms/five9/domains/{tenancy_id}/pauses/{pause_id}","href":"/api-reference/five9-domains/extend-a-domain-pauses-scheduled-resume"}]},{"group":"Admin — /v1/admin","pages":[{"title":"Reference data status","href":"/api-reference/reference-status"},{"title":"Pause all dispatch (break-glass)","deprecated":null,"version":null,"openapi":"/openapi.json post /admin/dispatch/pause","href":"/api-reference/dispatch/pause-all-dispatch-break-glass"},{"title":"Resume all dispatch (break-glass)","deprecated":null,"version":null,"openapi":"/openapi.json post /admin/dispatch/resume","href":"/api-reference/dispatch/resume-all-dispatch-break-glass"},{"title":"List everything holding dispatch","deprecated":null,"version":null,"openapi":"/openapi.json get /admin/dispatch/pauses","href":"/api-reference/dispatch/list-everything-holding-dispatch"},{"title":"Get one pause record","deprecated":null,"version":null,"openapi":"/openapi.json get /admin/dispatch/pauses/{pause_id}","href":"/api-reference/dispatch/get-one-pause-record"},{"title":"Reference data freshness","deprecated":null,"version":null,"openapi":"/openapi.json get /admin/reference/status","href":"/api-reference/reference-data/reference-data-freshness"},{"title":"Inbound delivery counts by status","deprecated":null,"version":null,"openapi":"/openapi.json get /admin/vendor-deliveries/counts","href":"/api-reference/vendor-deliveries/inbound-delivery-counts-by-status"}]}]}]},"basePath":"","title":"Update a credential - GetDialed Docs","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DX1Meug0.js","utils-B_OMIQVC.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChxhRPMa.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CuKvD8Iv.js","snippetPresets-C5d7p2hp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CfHcE8m4.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C1zZV314.js","shallow-CmQhqCJn.js","getApiPlaygroundDisplay-YRo9s1O7.js","CodeSnippet-RN1MTdfk.js","CodeSnippets-DKLPHxJA.js","Page-BAvA99GL.js","getPastedJson-bz0M41mU.js","icon-CsmhpPrv.js","MethodPill-CNGsVE77.js","DuplicateIcon-DilfU_Z2.js","createIcon-BdsYzQck.js","DynamicMarkdown-CbqEDjbV.js","SectionHeading-O6hXpFCN.js","axios-vUo_bRtp.js","Markdown-nKm-uidQ.js","clsx-ClVdStUn.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CIQkMg3R.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-ImrFS4Fy.js"]}