post/custom-field-values/{targetType}/{resourceId}/batch-readWrite operation

Read custom-field values for one resource

The cell-local App re-authenticates the credential and additionally requires a target-domain scope selected by targetType: contacts:read/write, projects:read/write, project-statements:read/write, or tasks:read/write. Reading a contact, project, tag, or user reference field, and validating a newly set reference, also requires the matching contacts:read, projects:read, tags:read, or users:read scope. Invalid legacy values are classified without exposing their payload. Batch reads accept 1–100 unique field ids for one resource and preserve request order.

Required scopes

custom-field-values:read

Conditional scopes

contacts:readprojects:readproject-statements:readtags:readtasks:readusers:read

Request example

curl --request POST \
  --url 'https://api.de.teamgrid.app/v1/custom-field-values/TARGET_TYPE/RESOURCE_ID/batch-read' \
  --header 'Authorization: Bearer $TEAMGRID_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "fieldIds": [
      "example"
    ]
  }'

const response = await fetch('https://api.de.teamgrid.app/v1/custom-field-values/TARGET_TYPE/RESOURCE_ID/batch-read', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.TEAMGRID_API_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "fieldIds": [
    "example"
  ]
}),
})

const result = await response.json()

type ApiResponse = unknown

const response = await fetch('https://api.de.teamgrid.app/v1/custom-field-values/TARGET_TYPE/RESOURCE_ID/batch-read', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.TEAMGRID_API_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "fieldIds": [
    "example"
  ]
}),
})

const result: ApiResponse = await response.json()

teamgrid custom-field-values batch-read \
  TARGET_TYPE \
  --data @payload.json

Example response 2xx

{
  "data": [
    "CustomFieldValue"
  ],
  "meta": {
    "requestId": "string"
  }
}

EndpointGerman region

Interactive request builder

Prepare this request

Build locally · nothing is sent

Region

Credential variable

targetTypepath · requiredresourceIdpath · required

JSON request bodyValid JSON

Generated cURL

The builder does not execute requests or persist credentials. Replace the environment-variable placeholder only in your terminal or secret-aware runtime.

Path parameters

targetTyperequired

string

Supported TeamGrid resource type that owns the custom-field value.

contactprojectproject-journal-entrytask

resourceIdrequired

string

Stable identifier of the target resource in the authenticated workspace.

Request body

application/json

fieldIdsrequired

array<string>

Ordered set of field identifiers associated with this custom field value batch read.

Responses

200Current value states in the same order as fieldIds.application/json

Response schemaapplication/json

required

array<CustomFieldValue>

Public API representation of custom field value.

required

ResponseMeta

Public API representation of meta.

400The request is invalid.application/json

Response schemaapplication/json

required

array<ApiError>

The errors associated with this error.

required

ResponseMeta

Request metadata, including the request identifier and pagination state when applicable.

401The bearer credential is missing, invalid, expired, or revoked.application/json

Response schemaapplication/json

required

array<ApiError>

The errors associated with this error.

required

ResponseMeta

Request metadata, including the request identifier and pagination state when applicable.

403The credential has insufficient scope.application/json

Response schemaapplication/json

required

array<ApiError>

The errors associated with this error.

required

ResponseMeta

Request metadata, including the request identifier and pagination state when applicable.

404The tenant-scoped resource does not exist.application/json

Response schemaapplication/json

required

array<ApiError>

The errors associated with this error.

required

ResponseMeta

Request metadata, including the request identifier and pagination state when applicable.

409The request conflicts with the current resource state.application/json

Response schemaapplication/json

required

array<ApiError>

The errors associated with this error.

required

ResponseMeta

Request metadata, including the request identifier and pagination state when applicable.

429The credential or source exceeded its rate limit.application/json

Response schemaapplication/json

required

array<ApiError>

The errors associated with this error.

required

ResponseMeta

Request metadata, including the request identifier and pagination state when applicable.

502The cell-local application returned an invalid response.application/json

Response schemaapplication/json

required

array<ApiError>

The errors associated with this error.

required

ResponseMeta

Request metadata, including the request identifier and pagination state when applicable.

503A required cell-local dependency is unavailable.application/json

Response schemaapplication/json

required

array<ApiError>

The errors associated with this error.

required

ResponseMeta

Request metadata, including the request identifier and pagination state when applicable.

Operation IDgetCustomFieldValuesOpenAPI JSON ↗

Documentation feedbackWas this page useful?