For Developers

Create Override

POST https://ed.link/api/v2/teams/:team_id/integrations/:integration_id/overrides

Creates a new override and schedules an integration materialization.

Permissions

Requires the overrides.update system permission.

Parameters

ParameterTypeRequiredDescription
:team_idUUIDYesThe ID of the team.
:integration_idUUIDYesThe ID of the integration.

Request Body

PropertyTypeRequiredDescription
typeStringYesTarget entity type (people, classes, etc.).
entity_idUUIDYesIdentifier of the entity being overridden.
actionStringYesOverride action (create, update, delete).
propertiesObjectYesMap of overridden field names and values.

Sample Request

const response = await axios.post(
    `https://ed.link/api/v2/teams/${team_id}/integrations/${integration_id}/overrides`,
    {
        type: 'people',
        entity_id: '4a18dc60-5ff0-482a-9e1e-28ebc9735d10',
        action: 'update',
        properties: {
            email: 'principal.anderson@oakridge.k12.org'
        }
    },
    {
        headers: {
            authorization: `Bearer ${user_session_token}`,
            'content-type': 'application/json'
        }
    }
);

Sample Response

{
    "$data": {
        "id": "90184b23-9041-4712-8819-102938475819",
        "type": "people",
        "entity_id": "4a18dc60-5ff0-482a-9e1e-28ebc9735d10",
        "action": "update"
    }
}