---
title: "Update Custom Record"
method: PATCH
path: "/custom_object_templates/{id}"
tags: ["Custom Records"]
---

# Update Custom Record

`PATCH /custom_object_templates/{id}`

## Request

- Base URL: `https://secure.fleetio.com/api`
- URL: `https://secure.fleetio.com/api/custom_object_templates/{id}`
- Auth: API key in header `Authorization` and API key in header `Account-Token`
- TypeScript: <https://skmtc.dev/fleetio/apis/fleetio-developer-api/docs/custom_object_templates/:id/patch.ts> (a function with typed inputs; its response is checked against the schema)

Updates an existing Custom Record on your account.

For update requests, the `{id}` path segment must be the custom record's Fleetio id.

## Path parameters

- `id` string, required

## Request body

- object
  - `custom_object_template` object, required
    - `name` string: The singular display name of the template.
    - `plural_name` string: The plural display name of the template.
    - `icon_name` string: The Fleetio icon name to use for this template.
    - `description` string, nullable: Optional descriptive text for the template.
    - `enabled` boolean: Whether to enable the template. Enabling requires at least one custom field configured for the template.

## Response `200`

OK

- CustomObjectTemplate: A Custom Record.
  - `account_id` integer, required: The Fleetio id of the account that owns this custom record.
  - `created_at` string, date-time, required
  - `description` string, nullable: Optional descriptive text for the custom record.
  - `enabled` boolean, required: Indicates whether this custom record is enabled for use.
  - `icon_name` string, required: The Fleetio icon name used to represent this custom record.
  - `id` integer, required
  - `key` string, required: The parameterized key generated for this custom record.
  - `name` string, required: The singular display name of the custom record.
  - `permissions` CustomObjectTemplatePermissions, required: What the requesting user may do with the records of this Custom Record type — not with the type definition itself, which is an administrator permission and is not reported here. `update` and `destroy` describe whether the role has that ability anywhere in the type; for a specific record, use the `permissions` on the Custom Object itself, which accounts for row-level restrictions.
    - `create` boolean, required: Indicates whether the user may create records of this type.
    - `update` boolean, required: Indicates whether the user may edit records of this type.
    - `destroy` boolean, required: Indicates whether the user may delete records of this type.
  - `plural_name` string, required: The plural display name of the custom record.
  - `type_permissions` CustomObjectTemplateTypePermissions, required: What the requesting user may do with this Custom Record type itself — adding a type, renaming one, or deleting one. This is an administrator permission, and is account-wide rather than per type: every type in the account reports the same answer. For what the user may do with the records of the type, use `permissions`.
    - `create` boolean, required: Indicates whether the user may add a Custom Record type.
    - `update` boolean, required: Indicates whether the user may rename or reconfigure this type.
    - `destroy` boolean, required: Indicates whether the user may delete this type.
  - `updated_at` string, date-time, required

## Other responses

- `401`: Request could not be authenticated
- `403`: Insufficient permission to perform this operation
- `404`: The requested resource could not be located
- `422`: Unprocessable Entity
- `500`: Something unexpected happened

## Changes

- **2026-11-06** `49558d744bd7`: 4 info
  - api tag `Custom Records` added
  - api tag `Custom Object Templates` removed
  - added the required property `permissions` to the response with the `200` status
  - added the required property `type_permissions` to the response with the `200` status
- **2026-06-16** `4098a1c81821`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fleetio/apis/fleetio-developer-api/changes/custom_object_templates/:id/patch.md)

---

[API](https://skmtc.dev/fleetio/apis/fleetio-developer-api.md) - [All operations](https://skmtc.dev/fleetio/apis/fleetio-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fleetio/apis/fleetio-developer-api/revisions/49558d744bd7?raw)