Possible limitations when using beta API endpoints?

devpd
devpd Member Posts: 3 VERIFIED MEMBER
Name Dropper First Comment

Hi!

I've reviewed the API reference and searched in the community, but haven't been able to find details about what "beta" means in the context of the Pipedrive API.

What are the limitations or risks of using beta API endpoints such as "Get all deals (BETA)", "Get all persons (BETA)" and "Get all organizations (BETA)" in a production integration?

Are there any plans to make major changes to these endpoints? And is there a timeline for when they will be released out of beta? Thanks!

Tagged:

Answers

  • dimka
    dimka Pipedrive Team Posts: 1 PIPEDRIVE TEAM
    First Comment Photogenic First Anniversary

    Hi!

    The BETA for v2 endpoints means that we are collecting feedback from API users. While we aim to avoid introducing any breaking changes to the APIv2 endpoints, the general API change management policy does not apply to the BETA endpoints. We have not yet published the APIv2 roadmap, but we plan to drop the BETA status before the end of 2024.

  • devpd
    devpd Member Posts: 3 VERIFIED MEMBER
    Name Dropper First Comment

    Thank you for the information @dimka !

  • devpd
    devpd Member Posts: 3 VERIFIED MEMBER
    Name Dropper First Comment

    Hi @dimka!

    Having reviewed the API documentation further for "Get all deals", it seems that the v2 endpoints are generally recommended to be used as v1 will be deprecated.

    However based on the docs the v2 endpoint does not have a query parameter for "filter_id". Is it possible to apply filters to this endpoint? Thanks in advance!

  • dimka
    dimka Pipedrive Team Posts: 1 PIPEDRIVE TEAM
    First Comment Photogenic First Anniversary

    Hi @devpd !

    Thank you for bringing this to our attention! I want to confirm that "Get all deals" v2 endpoint does support the filter_id parameter. We apologize for the oversight in our documentation, update is on its way!

    In the meantime, you can utilize filter_id in your API requests as intended.