Cannot add a Date value to my video via API

Help
,
1

So I’ve been working on uploading a lot of videos via API and to upload the “date recorded” would be very helpful. I’m able to upload all my other fields just fine, but can’t seem to figure out the payload expected for the date field.

This is the payload I recently tried

{

  "data": {

"file_ids": ["{file_id}"],

"values": [

      {

"field_definition_id": "405aeeac-71ba-4597-af83-611317b0b676",

"value": "2025-09-29T01:17:52Z"

      }

    ]

  }

}

I keep getting an error response

{

  "errors": [

    {

"detail": "Field definition 405aeeac-71ba-4597-af83-611317b0b676: Invalid value for date"

    }

  ]

}

I’m sure it’s just some simple solution, but I can’t seem to find the documentation for setting date values via the API. Appreciate any help.

Thanks

2

Update. I did not solve this fully but found a different solution for my use. I just decided to go with a string representation of the dates like YYYY-MM-DD HH:MM bc that still allows proper sorting. It would’ve been nice to get the actual date value working via API, but this works too.

3

Hi @redTurtle

Thanks for letting us know about this. I did some testing on my end, and confirmed that only a date value is being accepted. Using your example, this request works:

{
  "data": {
    "file_ids": ["{file_id}"],
    "values": [
      {
        "field_definition_id": "405aeeac-71ba-4597-af83-611317b0b676",
        "value": "2025-09-29"
    
      }
    ]
  }
}

However, the stored metadata value ends up being the provided date value + the time of the API request that updated it. Which is a bug.

A ticket has been created to address this, and I will share any updates here as they become available. In the meantime, the solution you mentioned is probably the best workaround.

Thanks again for bringing this to our attention. Let me know if you have any questions, or if there is anything else I can help you with.

4

Hi @redTurtle! We released a fix for this, so you should now be able to use a datetime value for your date recorded field without issue.

Feel free to let us know if you continue to see any issues, or if there is anything else you need help with!

5

If anyone has figured out the correct payload format for the “date documented” field in the API upload, please share. This would really help, especially for those of us working on large projects while also looking for cheap Ireland thesis writing help.

6

Hi @justinroy! Here’s an example of how to pass in a datetime value for your custom field:

{
  "data": {
    "file_ids": ["YOUR_FILE_ID"],
    "values": [
      {
        "field_definition_id": "YOUR_FIELD_DEFINITION_ID",
        "value": "2025-09-29T01:17:52Z"
    
      }
    ]
  }
}

If you need to find the field definition ID for your date documented field, you can do so using this endpoint: List account level field definitions | Frame.io API Documentation

I hope this helps!