Show examples in:
JavascriptHTTP
Endpoint info
Available examples
Content Management API > Field

Retrieve a field

Query parameters

fieldsobject

Sparse fieldsets: for each entity type, the attributes and the relationships to return, separated by commas. Each entity declares its attributes and its relationships in its own schema.

fieldstring

Attributes and relationships to return for each field that this endpoint returns.

Example:"label,field_type,localized,item_type"

Returns

Returns a resource object of type field

Examples

import { buildClient } from "@datocms/cma-client-node";
async function run() {
const client = buildClient({ apiToken: process.env.DATOCMS_API_TOKEN });
const fieldIdOrApiKey = "blog_post::title";
const field = await client.fields.find(fieldIdOrApiKey);
// Check the 'Returned output' tab for the result ☝️
console.log(field);
}
run();
{
id: "Pkg-oztERp6o-Rj76nYKJg",
label: "Title",
field_type: "string",
api_key: "title",
localized: true,
validators: { required: {} },
position: 1,
hint: "This field will be used as post title",
default_value: { en: "A default value", it: "Un valore di default" },
appearance: {
editor: "single_line",
parameters: { heading: false },
addons: [{ id: "1234", field_extension: "lorem_ipsum", parameters: {} }],
},
deep_filtering_enabled: true,
content_link_enabled: true,
item_type: { type: "item_type", id: "DxMaW10UQiCmZcuuA-IkkA" },
fieldset: null,
}