https://vapi.ai/ logo
Join Discord
Powered by
API request not working
# support
p
whenever i am trying to save my flow i am having this error i have no tool nodes but just one api node which is also properly set up, please help me solve the issue @Vapi Support Bot https://cdn.discordapp.com/attachments/1450236850743541923/1450236851695652884/Screenshot_2025-12-16_024731.png?ex=6941cdd1&is=69407c51&hm=f62d3d27795344f079e37dc48350022ab24fd5d1c36303c4e73a9b56c46da26d&
@Vapi Support Bot
v
It looks like your API node's 
credentialId
is not in the correct format. To fix this, go to the Vapi dashboard, create a new Custom Credential, and copy the generated credential ID (e.g., 
cred_abc123
). Then, update your API node configuration like this:
Copy code
json
{
  "server": {
    "url": "https://your-server.com/webhook",
    "credentialId": "cred_abc123"
  }
}
This should resolve the "credentialId must be a UUID" error. For more details, see the [Vapi server authentication documentation](https://docs.vapi.ai/server-url/server-authentication). Source: - [Server authentication | Vapi Docs](https://docs.vapi.ai/server-url/server-authentication)
Try this: Double-check your API node's configuration and ensure that any field labeled 
credentialId
is either left empty (if not required) or set to a valid UUID (e.g., 
123e4567-e89b-12d3-a456-426614174000
). If you see a credential or server field, clear it or select a valid credential from the dropdown, then try saving again. This error usually means a required ID is missing or incorrectly formatted—fixing it should let you save your workflow. For more details, review your node settings and check for required fields as suggested in the [debugging guide](https://docs.vapi.ai/debugging). Source: - [Debugging voice agents](https://docs.vapi.ai/debugging)
p
@Vapi Support Bot how do i update my api node configuration
@Pappumaster
v
To update your API node configuration, go to the Vapi dashboard, create a new Custom Credential, and copy its credential ID. Then, update your API node's server section like this:
Copy code
json
{
  "server": {
    "url": "https://your-server.com/webhook",
    "credentialId": "cred_abc123"
  }
}
Replace the URL and credentialId with your actual values, then save your workflow. For more details, see the [API Request node documentation](https://docs.vapi.ai/workflows/nodes/api-request). Sources: - [API Request node documentation](https://docs.vapi.ai/workflows/nodes/api-request) - [Server authentication | Vapi Docs](https://docs.vapi.ai/server-url/server-authentication)
p
but there is no option to edit json code in vapi @Vapi Support Bot
v
Since you can't edit JSON directly in Vapi, update your API node by selecting it in the workflow visual builder, then look for the "Server" or "Authentication" section in the right-side panel. From there, choose a valid Custom Credential from the dropdown (or create a new one if needed), and make sure the server URL is set correctly. Click "Save" to apply your changes. This should resolve the credentialId error—if you don't see the option, try refreshing the page or checking for required fields in the node settings. For more details, see the [Workflows overview](https://docs.vapi.ai/workflows/overview). Source: - [Workflows overview](https://docs.vapi.ai/workflows/overview)
p
I cant see no credential but i have make connected in vapi @Vapi Support Bot
v
To resolve the missing credential issue: Go to the Vapi dashboard, navigate to Custom Credentials (usually found in organization or security settings), and create a new credential (e.g., Bearer Token). Once created, return to your API node, and you should now see the credential available in the dropdown for selection. If you still don't see it, try refreshing the page or logging out and back in. For step-by-step details, see the [server authentication guide](https://docs.vapi.ai/server-url/server-authentication). Source: - [Server authentication | Vapi Docs](https://docs.vapi.ai/server-url/server-authentication)
p
v
You're currently in the "Integrations" section, but you need to go to "Custom Credentials" to create the required credential. 1. In the Vapi dashboard, look for "Custom Credentials" (usually under "Org Settings" or "Security"). 2. Create a new credential (e.g., Bearer Token) and save it. 3. Return to your API node, and you should now see your new credential in the dropdown for selection. If you still don't see it, try refreshing the page or logging out and back in. For step-by-step details, see the [server authentication guide](https://docs.vapi.ai/server-url/server-authentication). Source: - [Server authentication | Vapi Docs](https://docs.vapi.ai/server-url/server-authentication)
p
@Vapi Support Bot
v
Try this: Check if there are any hidden or legacy tool nodes in your workflow by removing all nodes and re-adding only your API node, then save again. Sometimes, invisible or leftover nodes can cause this error even if you only see an API node. If the error persists, create a new workflow from scratch and add your API node with the correct credential, as this often resolves hidden configuration issues. For more details, see the [server authentication guide](https://docs.vapi.ai/server-url/server-authentication). Source: - [Server authentication | Vapi Docs](https://docs.vapi.ai/server-url/server-authentication)
p
still that error is there @Vapi Support Bot
v
Try creating a brand new workflow: Delete your current workflow, then create a new one from scratch. Add only the API node, select your valid Custom Credential from the dropdown in the "Server" or "Authentication" section, and save. This often resolves hidden configuration issues that cause the 
credentialId must be a UUID
error. If the error still appears, double-check that no other nodes (especially tool nodes) are present, even if they're not visible. For more details, see the [server authentication guide](https://docs.vapi.ai/server-url/server-authentication). Source: - [Server authentication | Vapi Docs](https://docs.vapi.ai/server-url/server-authentication)
p
@Vapi Support Bot i did in a brand new workflow
v
Since you've already tried creating a new workflow and still see the error, double-check that your Custom Credential's ID matches the required format (e.g., 
cred_abc123
) and is selected in the API node's "Server" section. If the credentialId looks correct and the error persists, this may be a platform issue—please contact Vapi support with your workflow details and a screenshot of your Custom Credential for further assistance. For reference, credential IDs should look like:
Copy code
json
"credentialId": "cred_abc123"
See the [server authentication guide](https://docs.vapi.ai/server-url/server-authentication) for more details. Source: - [Server authentication | Vapi Docs](https://docs.vapi.ai/server-url/server-authentication)
p
but i already have a custom credential
@Vapi Support Bot
v
Thanks for confirming you have a custom credential. Could you please check and share (or confirm) the exact format of your credential ID (e.g., does it look like 
cred_abc123
), and confirm that this ID is selected in your API node's "Server" or "Authentication" section? This will help determine if the issue is with the credential format or selection. Source: - [Server authentication | Vapi Docs](https://docs.vapi.ai/server-url/server-authentication)
p
@Vapi Support Bot how do i make changes to the json code of my workflow
v
To update your workflow's JSON directly, use the Vapi API's PATCH endpoint. Here’s an example using 
curl
(replace 
<workflow_id>
, 
<your_token>
, and the JSON as needed):
Copy code
bash
curl -X PATCH https://api.vapi.ai/workflow/<workflow_id> \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json" \
  -d '{ "nodes": [ /* your updated nodes here */ ] }'
This lets you edit the workflow JSON directly—see the [API reference](https://docs.vapi.ai/api-reference/workflow/workflow-controller-update) for details. Source: - [API Reference: Update Workflow](https://docs.vapi.ai/api-reference/workflow/workflow-controller-update)
p
@Vapi Support Bot how can i use the api's patch endpoint, guide me step by step as it is
v
Step-by-step: Update your workflow using the PATCH endpoint 1. Open your terminal. 2. Run the following command (replace 
<workflow_id>
, 
<your_token>
, and the JSON as needed):
Copy code
bash
curl -X PATCH https://api.vapi.ai/workflow/<workflow_id> \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json" \
  -d '{ "nodes": [ /* your updated nodes here */ ] }'
This will update your workflow directly via the API. For more details, see the [API reference](https://docs.vapi.ai/api-reference/workflow/workflow-controller-update). Source: - [API Reference: Update Workflow](https://docs.vapi.ai/api-reference/workflow/workflow-controller-update)
p
do i need to open terminal in my computer or vapi @Vapi Support Bot
v
You need to open the terminal on your own computer (such as Command Prompt, Terminal, or PowerShell), not inside Vapi. Run the 
curl
command there to update your workflow via the API:
Copy code
bash
curl -X PATCH https://api.vapi.ai/workflow/<workflow_id> \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json" \
  -d '{ "nodes": [ /* your updated nodes here */ ] }'
For more details, see the [API reference](https://docs.vapi.ai/api-reference/workflow/workflow-controller-update). Source: - [API Reference: Update Workflow](https://docs.vapi.ai/api-reference/workflow/workflow-controller-update)
p
what do i need to type in this in order to change the credential id
@Vapi Support Bot
v
To change the credential ID in your workflow, update the 
credentialId
field in your API node's 
server
section. Here’s an example 
curl
command (replace the placeholders with your actual values):
Copy code
bash
curl -X PATCH https://api.vapi.ai/workflow/<workflow_id> \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "nodes": [
      {
        "type": "apiRequest",
        "name": "My API Node",
        "server": {
          "url": "https://your-api.com/endpoint",
          "credentialId": "cred_abc123"
        }
        // ...other node fields as needed
      }
    ]
  }'
Just replace 
"cred_abc123"
with your actual credential ID and fill in your node details as needed. See the [API reference](https://docs.vapi.ai/api-reference/workflow/workflow-controller-update) for more info. Source: - [API Reference: Update Workflow](https://docs.vapi.ai/api-reference/workflow/workflow-controller-update)
p
please @Vapi Support Bot i need help of a professional to help as you are not enough
My Vapi org appears to be stuck in a tool-enabled state. Even brand new agents with only Conversation + API Request nodes fail to save with: "nodes.tool.server.credentialId must be a UUID" I have already created custom credentials as advised. This did not resolve the issue. Please reset the tool/server state for my org or disable tool validation. @User sorry to ping at this time but please i need urgent help
@Vapi Support Bot nothing worked i did create the credential but still did not work
v
Since all standard troubleshooting has failed and your org appears stuck, the best next step is to contact Vapi support directly with a detailed summary. Please email support@vapi.ai (or use the in-app support chat) and include: - Your org name and workflow ID - The exact error message: 
"nodes.tool.server.credentialId must be a UUID"
- Steps you've already taken (custom credential creation, new workflow, etc.) This will help the Vapi team investigate and reset your org's tool/server state as needed. For reference, see the [server authentication documentation](https://docs.vapi.ai/server-url/server-authentication). Source: - [Server authentication | Vapi Docs](https://docs.vapi.ai/server-url/server-authentication)
c
please provide the workflow id
PreviousNext
Powered by