Skip to content
Developer docsAPI referenceTemplates

Delete a template

Deletes a template.

DELETEhttps://runner.cargoduo.com/v1/templates/{id}

Items already in projects stay. Free: no credits are charged.

Authentication

Bearer API key with scoperesources:writeLearn more

Path parameters

NameTypeRequiredDescription
idstringrequired
string
Yes

Template id (tpl_…).

Example request

curl -X DELETE "https://runner.cargoduo.com/v1/templates/tpl_42" \
  -H "Authorization: Bearer $CARGODUO_API_KEY"

Example response

200 OK · Deleted
{
  "id": "tpl_42",
  "object": "template",
  "deleted": true
}

Responses

  • 200OKDeleted.
    NameTypeRequiredDescription
    idstring
    string
    No
    objectstring
    string
    No
    vehicletemplateproject
    deletedboolean
    boolean
    No

    Always true.

  • 401Unauthorizedunauthorizedkey_revokedkey_expired
    • unauthorizedMissing, malformed or unknown API key.
    • key_revokedThe key was revoked.
    • key_expiredThe key passed its expiry date.
    NameTypeRequiredDescription
    errorErrorBodyrequired
    ErrorBody
    Yes
    All error codes
  • 403Forbiddenip_not_allowedsubscription_inactiveaccount_inactivescope_missing
    • ip_not_allowedThe calling IP is not on the key's allowlist.
    • subscription_inactiveThe organization has no active subscription that includes the API.
    • account_inactiveThe organization is suspended, or has no owner whose account is active.
    • scope_missingThe key lacks a scope this endpoint needs.
    NameTypeRequiredDescription
    errorErrorBodyrequired
    ErrorBody
    Yes
    All error codes
  • 404Not foundtemplate_not_found
    • template_not_foundNo template with this id in your organization.
    NameTypeRequiredDescription
    errorErrorBodyrequired
    ErrorBody
    Yes
    All error codes
  • 429Too many requestsrate_limited
    • rate_limitedToo many requests in the current minute, hour or day (per key or per organization), or more than 60 failed authentications per minute from your IP address.
    NameTypeRequiredDescription
    errorErrorBodyrequired
    ErrorBody
    Yes
    All error codes
  • 500Internal server errorinternal_error
    • internal_errorSomething failed on our side.
    NameTypeRequiredDescription
    errorErrorBodyrequired
    ErrorBody
    Yes
    All error codes
  • 503Service unavailableapi_disabled
    • api_disabledThe API is temporarily disabled (maintenance) or switched off for the organization.
    NameTypeRequiredDescription
    errorErrorBodyrequired
    ErrorBody
    Yes
    All error codes