For Developers

Requests Overview

Edlink logs all requests made through our API for each integration. We erase requests from our database after 30 days. Using the Meta API you can view and filter requests that you have made.

PropertyTypeDescription
idstringThe UUID for the Request.
$filter operators: equals in not in
dateDateThe date the Request was created
start_dateDateThe date time the Request started
end_dateDateThe date time the Request ended
methodstringThe HTTP method of the Request
pathstringThe path of the Request that the API server recieved
statusnumberThe HTTP status the Request resolved to
propertiesobjectExtra information about the Request like the client ip, server id, query, etc.
inputobjectThe payload recieved from the client for this Request
outputobjectThe payload returned by the server to the client for this Request
idempotency_keystring, nullThe idempotency key used for this Request if there was one
categoriesstring[]Any relevant categories (e.g. sso, coursework, etc.)
person_idstring, nullThe associated Person with this Request if there is one
integration_idstring, nullThe associated Integration with this Request if there is one
developer_idstring, nullThe developer team_id associated with this Request if there is one
district_idstring, nullThe district team_id associated with this Request if there is one
user_idstring, nullThe Edlink user associated with this Request if there is one

JSON Example

{
    "date": "2025-09-29T17:49:06.043Z",
    "start_date": "2025-09-29T17:49:06.039Z",
    "end_date": "2025-09-29T17:49:06.042Z",
    "method": "GET",
    "path": "/api/v2/graph/materializations?$last=1&$filter=%7B%22state%22:[%7B%22operator%22:%22equals%22,%22value%22:%22complete%22%7D]%7D",
    "status": 400,
    "properties": {
        "ip": "00.00.000.00",
        "query": {
            "$last": "1",
            "$filter": "{\"state\":[{\"operator\":\"equals\",\"value\":\"complete\"}]}"
        },
        "api_server": "Unknown",
        "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/140.0.0.0 Safari/537.36"
    },
    "input": {},
    "output": {
        "$errors": [
            {
                "code": "INVALID_INTEGRATION_STATE",
                "message": "The integration associated with your access token is not marked as 'active' or 'paused'."
            }
        ],
        "$request": "3671b422-109f-40df-ba8a-53cb0fca9f52"
    },
    "idempotency_key": null,
    "categories": [],
    "person_id": null,
    "integration_id": "e869b2db-0c91-4765-84ab-3275e2403a43",
    "developer_id": "3943245f-7033-4f5f-a32c-861effdc64b7",
    "district_id": "3943245f-7033-4f5f-a32c-861effdc64b7",
    "user_id": null,
    "id": "3671b422-109f-40df-ba8a-53cb0fca9f52"
}