diff --git a/models/track/public-api-guide.mdx b/models/track/public-api-guide.mdx index 2022c24c5b..bfd02b23fb 100644 --- a/models/track/public-api-guide.mdx +++ b/models/track/public-api-guide.mdx @@ -340,6 +340,8 @@ You can filter by using the MongoDB Query Language. #### Date +`created_at` values are ISO 8601 timestamps in UTC. Use the same format for the bounds: + ```python runs = api.runs( "/", @@ -528,6 +530,8 @@ run = api.run("entity/project/run_id") start_time = run.created_at ``` +`run.created_at` is an ISO 8601 timestamp in UTC (for example, `"2023-01-01T12:00:00Z"`). The same convention applies to the `created_at` and `updated_at` fields on other public API objects, such as `Registry`, `ArtifactCollection`, and `Project`. Convert to a local timezone with `datetime.fromisoformat(start_time.replace("Z", "+00:00"))` and then `.astimezone()`. + ### Upload files to a finished run The code snippet below uploads a selected file to a finished run.