Add meta as a query param of REST API /v6/deployments, like CLI list

[jjangga0214]

CLI docs: https://vercel.com/docs/cli#commands/list/extended-usage

meta can be passed to CLI's list command.

However, REST API /v6/deployments does not have such a query parameter.

REST API docs: https://vercel.com/docs/rest-api#endpoints/deployments/list-deployments

Thus hereby I request the feature.

Thanks :)

[amyegan]

Thanks for sharing your idea! I'm adding it to list of requested features.

[jjangga0214]

@amyegan Hi!
This hasn't been implemented yet.
May I ask if this idea is on a to-do list or just ignored?
Thanks.

[emmanuelvacher]

Hello @jjangga0214,

It seems not to be documented but you can filter by meta (I've used this feature just today).

Below is an example curl command that filters deployment by meta.githubCommitSha (automatically set by the GitHub integration) and meta.foo (user-defined):

curl -XGET -H "Authorization: Bearer $VERCEL_TOKEN" \
  https://api.vercel.com/v6/deployments?teamId=<TEAM_ID>&app=<PROJECT_ID>&meta-githubCommitSha=<COMMIT_SHA>&meta-foo=barr

[jjangga0214]

@emmanuelvacher Wow, great! How did you find the way? Guesswork?

@amyegan This should be definitely documented!