--- title: DevRev API Integration on Truto slug: devrev category: Ticketing canonical: "https://truto.one/integrations/detail/devrev/" --- # DevRev API Integration on Truto **Category:** Ticketing **Status:** Generally available ## Unified APIs ### Unified User Directory API - **Groups** — Groups are a collection of users in the source application. In some applications, they might also be called Teams. - **Me** — - **Organizations** — Organizations are the top level entity in the source application. Users are associated with an organization. - **Users** — The User object represents a User. ## MCP-ready AI tools Truto exposes 101 tools for DevRev that AI agents can call directly. - **list_all_devrev_me** — Get information about the authenticated user in DevRev. Returns fields including id, created_by, created_date, display_id, display_name, display_picture, email, full_name, state, experience_start_date, external_identities, job_history, modified_by, modified_date, phone_numbers, and skills. - **list_all_devrev_dev_users** — List users within your organization in DevRev. Returns fields including id, created_by, created_date, display_id, display_name, email, full_name, state, job_history, modified_by, modified_date, phone_numbers, skills, and external_identities. - **get_single_devrev_dev_user_by_id** — Get information about a specific user by id in DevRev. Returns fields including id, created_by, created_date, display_id, display_name, display_picture, email, full_name, state, job_history, modified_by, modified_date, phone_numbers, skills, and external_identities. - **list_all_devrev_dev_org_auth_connections** — List all authentication connections for a Dev organization in DevRev. Returns type, display_name, enabled status, id, client_id, and tenant_domain for each connection. - **get_single_devrev_dev_org_auth_connection_by_id** — Get details of a specific authentication connection in DevRev by id. Returns type, display_name, enabled status, id, client_id, and tenant_domain fields. - **create_a_devrev_dev_org_auth_connection** — Create a new enterprise authentication connection in DevRev. Requires specifying the type and configuration parameters. Only 5 connections allowed per organization. Returns the created auth connection details. - **update_a_devrev_dev_org_auth_connection_by_id** — Update an authentication connection by id in DevRev. Returns the updated auth_connection object with configuration details. - **delete_a_devrev_dev_org_auth_connection_by_id** — Delete an authentication connection by id in DevRev. Only enterprise connections explicitly set up for a Dev organization can be deleted; default connections cannot be deleted using this method. - **devrev_dev_org_auth_connections_toggle** — Toggle an authentication connection for a Dev organization by providing the id of the connection and the toggle action (enable or disable). At least one authentication connection must remain enabled. - **list_all_devrev_rev_orgs** — Get list of Rev organizations belonging to the authenticated user's Dev Organization in DevRev. Returns id, created_by, created_date, description, display_id, display_name, external_ref, modified_by, modified_date, and domain for each organization. - **get_single_devrev_rev_org_by_id** — Get information about a specific Rev organization in DevRev. Requires id or accountstring. Returns id, created_by, created_date, description, display_id, display_name, external_ref, modified_by, modified_date, and domain fields. - **create_a_devrev_rev_org** — Create a Rev organization with display_name in DevRev. Returns the created rev_org object with details including id, description, environment, and tier. - **update_a_devrev_rev_org_by_id** — Update Rev organization information by id in DevRev. Returns updated rev_org object with properties including description, display_name, environment, external_ref, and tier. - **delete_a_devrev_rev_org_by_id** — Delete a Rev organization by id in DevRev. Requires id. - **list_all_devrev_sys_users** — List system users in DevRev. Returns id, created_by, created_date, display_id, display_name, display_picture, email, full_name, modified_by, modified_date, phone_numbers, and state for each user. - **update_a_devrev_sys_user_by_id** — Update a system user by id in DevRev. Returns updated user details including display_names, display_picture, and full_name. - **list_all_devrev_rev_users** — List all Rev Users in DevRev. Returns fields including id, created_by, created_date, description, display_id, display_name, email, external_ref, full_name, modified_by, modified_date, phone_numbers, rev_org, and state. - **get_single_devrev_rev_user_by_id** — Get Rev user by id in DevRev. Returns fields including id, created_by, created_date, description, display_id, display_name, display_picture, email, external_ref, full_name, modified_by, modified_date, phone_numbers, rev_org, and state. - **create_a_devrev_rev_user** — Create a Rev user for a Rev organization in DevRev. Returns the created rev_user object with details such as id, display_name, email, phone_numbers, and rev_org. - **update_a_devrev_rev_user_by_id** — Update a Rev user by id in DevRev. Returns the updated rev_user object including fields such as display_name, email, description, and phone_numbers. - **delete_a_devrev_rev_user_by_id** — Delete a Rev user by id in DevRev. Requires id. The response confirms the deletion of the specified Rev user. - **list_all_devrev_groups** — List available groups in DevRev. Returns fields including id, created_by, created_date, modified_by, modified_date, and display_id for each group. - **get_single_devrev_group_by_id** — Get information about a specific group in DevRev by id. Returns group details including id, created_by and modified_by user info, created_date, modified_date, and display identifiers. - **create_a_devrev_group** — Create a new group in DevRev with required parameters description and name. Returns group id, created_by and modified_by user details, created_date, modified_date, and display_id. - **update_a_devrev_group_by_id** — Update group by id in DevRev. Returns the updated group's id, name, description, and owner. - **list_all_devrev_group_members** — List members of a group in DevRev by group. Returns member details including type, id, display_id, display_name, email, full_name, state, and member_rev_org info. - **create_a_devrev_group_member** — Add a member to a group in DevRev. Requires group and member IDs. Optionally specify member_rev_org if the member is a rev user. Returns the added member details. - **delete_a_devrev_group_member_by_id** — Remove a member from a group in DevRev. Requires group and member. Optionally specify member_rev_org if the member is a rev user. Returns confirmation of removal. - **list_all_devrev_accounts** — Get a list of accounts in DevRev. Returns accounts with fields including id, owned_by (user details), created_by, created_date, description, display_id, display_name, domains, external_refs, modified_by, modified_date, tier, and websites. - **get_single_devrev_account_by_id** — Get information about a specific account in DevRev by id. Returns fields including id, owned_by (type, id, display_id, display_name, display_picture, email, full_name, state), created_by, created_date, description, display_id, display_name, domains, external_refs, modified_by, modified_date, tier, and websites. - **create_a_devrev_account** — Create an account in DevRev with the required display_name. Returns the created account's details including id, display_name, description, domains, external_refs, owned_by, tier, and websites. - **update_a_devrev_account_by_id** — Update an account's information in DevRev using id. Returns the updated account object including properties like description, display_names, domains, external_refs, owned_by, tier, and websites. - **delete_a_devrev_account_by_id** — Delete an account by id in DevRev. Requires id. The response confirms the deletion. - **devrev_accounts_export** — Export a collection of accounts in DevRev. Returns the accounts array with account details. - **list_all_devrev_artifacts** — List artifacts attached to an object in DevRev. Requires parent_id to filter artifacts. Returns artifact id, created_by and modified_by user info, created_date, modified_date, display_id, and file details. - **get_single_devrev_artifact_by_id** — Get information about a specific artifact by id in DevRev. Returns artifact details including id, created_by, created_date, display_id, file info, modified_by, modified_date, and version metadata. - **create_a_devrev_artifact** — Create an artifact and generate an upload URL by providing file_name. Returns id (artifact's ID) and url (upload URL) in the response. - **devrev_artifacts_locate** — Get the download URL for an artifact in DevRev by providing the artifact id. Returns the URL to download the specified artifact. - **list_all_devrev_parts** — List parts in DevRev. Returns an array of parts with fields including id, name, type, owned_by (user details), artifacts (files), created_by, created_date, description, modified_by, modified_date, and tags. - **get_single_devrev_part_by_id** — Get information about a specific part by id in DevRev. Returns fields including type, id, name, owned_by (users), artifacts, created_by, created_date, description, display_id, modified_by, modified_date, and tags. - **create_a_devrev_part** — Create a new part in DevRev with required fields: type, name, owned_by, and parent_part. Returns the created part including its id, type, name, owned_by, parent_part, and optional description, artifacts, and tags. - **update_a_devrev_part_by_id** — Update a part by id in DevRev. Returns the updated part's type, id, name, ownership details, artifacts, creator, creation and modification dates, description, display_id, modifier, and tags. - **delete_a_devrev_part_by_id** — Delete a part by id in DevRev. Requires id. Returns success confirmation. - **list_all_devrev_tags** — List available tags in DevRev. Returns tags with fields id, name, allowed_values, created_by, created_date, description, display_id, modified_by, and modified_date. - **get_single_devrev_tag_by_id** — Get information about a specific tag in DevRev by id. Returns tag fields including id, name, allowed_values, created_by, created_date, description, display_id, modified_by, and modified_date. - **create_a_devrev_tag** — Create a new tag in DevRev with a unique name. Returns the created tag including its name, allowed_values, and description. - **update_a_devrev_tag_by_id** — Update a tag's information in DevRev using id. Returns the updated tag including id, name, description, and allowed_values. - **delete_a_devrev_tag_by_id** — Delete a tag by id in DevRev. Returns the response for the delete operation. - **list_all_devrev_timeline_entries** — List timeline entries for an object in DevRev. Requires object parameter. Returns timeline entries with fields including id, type, body, created_by, created_date, modified_by, modified_date, visibility, and related artifacts. - **get_single_devrev_timeline_entry_by_id** — Get a timeline entry by id in DevRev. Returns fields including type, id, object, object_display_id, artifacts (id, display_id, file details), body, body_type, created_by (user details), created_date, display_id, modified_by (user details), modified_date, object_type, references, snap_kit_body, snap_widget_body, and visibility. - **create_a_devrev_timeline_entry** — Create a timeline entry for an object in DevRev. Requires type as 'timeline_comment' and object id. Returns timeline entry with id, object, artifacts, body, body_type, created_by, created_date, modified_by, modified_date, visibility, and references. - **update_a_devrev_timeline_entry_by_id** — Update a timeline entry by id in DevRev. Returns the updated timeline entry including id, body, body_type, artifacts, created_by, created_date, modified_by, modified_date, object_type, references, snap_kit_body, snap_widget_body, and visibility. - **delete_a_devrev_timeline_entry_by_id** — Delete a timeline entry by id in DevRev. Requires id of the timeline entry to delete. Returns the response to the delete operation. - **list_all_devrev_webhooks** — List webhooks in DevRev. Returns id, secret, status, url, created_by, created_date, modified_by, modified_date, display_id, and event_types for each webhook. - **get_single_devrev_webhook_by_id** — Get information about a specific webhook in DevRev by id. Returns webhook fields including id, secret, status, url, created_by, created_date, display_id, event_types, modified_by, and modified_date. - **create_a_devrev_webhook** — Create a webhook in DevRev with the required url. Returns webhook id, url, event_types, and secret if provided or generated. - **update_a_devrev_webhook_by_id** — Update a webhook by id in DevRev. Returns the updated webhook object including its status, url, secret, and event types. If active, webhook status transitions to 'unverified' until verified. - **delete_a_devrev_webhook_by_id** — Delete webhook with id. Returns the response to the delete operation in DevRev. - **devrev_webhooks_event** — Create a webhook event in DevRev with required id and webhook_id. Returns event details including account information with id, owned_by users, created_by, description, display_id, display_name, domains, external_refs, modified_by, tier, and websites. - **list_all_devrev_works** — List work items in DevRev. Returns fields including id, type, title, applies_to_part, created_by, owned_by, reported_by, priority, priority_v2, stage, sla_summary, sprint, tags, body, created_date, modified_date, and artifacts. - **get_single_devrev_work_by_id** — Get information about a specific work item in DevRev using id. Returns the work item's details including key fields. - **create_a_devrev_work** — Create a new work item of type issue or ticket in DevRev. Requires type, applies_to_part, owned_by, and title. Returns the created work with fields including id, type, owned_by, title, applies_to_part, artifacts, body, created_by, created_date, priority, reported_by, sprint, stage, tags, target_close_date, and target_start_date. - **update_a_devrev_work_by_id** — Update a work item by id in DevRev. Returns updated work fields including id, title, body, priority, stage, and target_close_date. - **delete_a_devrev_work_by_id** — Delete a work by id in DevRev. Requires id of the work to be deleted. - **devrev_works_export** — Export a collection of work items in DevRev. Supports filtering by parameters such as applies_to_partlist, created_by, issue.accounts, issue.priority, owned_by, reported_by, stage.name, state, tags, ticket.channels, and type. Returns an array of work items with detailed fields. - **list_all_devrev_articles** — List articles in DevRev. Returns fields including id, owned_by (user details), applies_to_parts, article_type, authored_by, created_by, created_date, description, extracted_content, modified_by, modified_date, num_upvotes, num_downvotes, parent, rank, resource, scope, and title. - **get_single_devrev_article_by_id** — Get an article by id in DevRev. Returns fields including id, owned_by (owners' details), applies_to_parts (capabilities), article_type, authored_by, created_by, created_date, description, display_id, extracted_content, modified_by, modified_date, num_downvotes, num_upvotes, parent, rank, resource (artifacts), scope, and title. - **create_a_devrev_article** — Create an article in DevRev with required fields applies_to_parts, owned_by, and resource including title. Returns the created article object with details such as status, published_at, and tags. - **update_a_devrev_article_by_id** — Update an article by id in DevRev. Requires id, set (aliases), and content_blocks. Returns the updated article object including fields like title, description, status, tags, and published_version. - **delete_a_devrev_article_by_id** — Delete an article by id in DevRev. Requires id. Returns success confirmation. - **get_single_devrev_atom_by_id** — Get an atom by id in DevRev. Returns fields including type, id, client_id, created_by (user info), created_date, modified_by (user info), modified_date, status, scopes, and token details. - **list_all_devrev_conversations** — List conversations in DevRev. Returns conversation id, members with details (type, id, display_name, email, state), channels, created_by info, created_date, description, group, messages with body and created_by, metadata, modified_by, owned_by, sla_summary, and title. - **get_single_devrev_conversation_by_id** — Get information about a specific conversation in DevRev by id. Returns fields including id, members (type, id, display_name, email, state), channels, created_by, created_date, description, group, messages (type, id, body, created_by), metadata, modified_by, owned_by, sla_summary, sla_tracker, stage, and tags. - **create_a_devrev_conversation** — Create a support conversation in DevRev. Returns the conversation object including id, title, description, members, owned_by, tags, and other conversation details. - **update_a_devrev_conversation_by_id** — Update a conversation by id in DevRev. Returns the updated conversation fields including title, description, status, tags, members, owners, and channels. - **delete_a_devrev_conversation_by_id** — Delete a conversation by id in DevRev. Requires id. - **list_all_devrev_links** — List links for the object with id in DevRev. Returns links array with link details and cursors for pagination. - **get_single_devrev_link_by_id** — Get information about a specific link in DevRev by id. Returns fields including id, link_type, source and target details with type, id, name, owned_by, display_id, created_by, created_date, modified_by, and modified_date. - **create_a_devrev_link** — Create a link between two objects in DevRev by specifying link_type, source, and target. Returns the created link object with its details. - **delete_a_devrev_link_by_id** — Delete a link by id in DevRev. Requires id. Returns an empty response upon successful deletion. - **get_single_devrev_service_account_by_id** — Get a service account by id in DevRev. Returns fields including id, created_by, created_date, display_id, display_name, display_picture, email, full_name, modified_by, modified_date, phone_numbers, and state. - **create_a_devrev_service_account** — Create a service account in DevRev with the required display_name. Returns the created service account details including its unique identifier and display name. - **devrev_snap_kit_execution_execute** — Execute deferred snap-kit actions in DevRev using the required id and actions list containing action_id, timestamp, type, and value. Returns success confirmation. - **list_all_devrev_surveys_responses** — List survey responses in DevRev. Returns survey_responses array with details of each response. Supports filtering by created_by, dispatch_ids, objects, recipient, stages, surveys, and sorting options. - **update_a_devrev_surveys_response_by_id** — Update a user's survey response using dispatch_id in DevRev. Returns updated response details including response_channel, response_score, and stage. - **list_all_devrev_auth_tokens** — Get metadata for all auth tokens filtered by optional client_id, requested_token_type, and subject in DevRev. Returns id, client_id, created_by, created_date, modified_by, modified_date, requested_token_type, scopes, status, subject, token_hint, and expiration details. - **get_single_devrev_auth_token_by_id** — Get metadata for a specific auth token in DevRev using token_id. Returns token fields including id, client_id, created_by, created_date, expires_at, issued_at, modified_by, modified_date, requested_token_type, scopes, status, subject, and token_hint. - **create_a_devrev_auth_token** — Create an auth token in DevRev. Returns access_token (JWT), expires_in (token lifetime in seconds), token_type (bearer), and optionally client_id, refresh_token, and scopes. - **update_a_devrev_auth_token_by_id** — Update token metadata using token_hint and token_id in DevRev. Returns the updated token details including token_id and token_hint. - **delete_a_devrev_auth_token_by_id** — Delete an auth token by token_id in DevRev. If token_id is not provided, the token ID is taken from the JTI claim of the authorization header. - **devrev_auth_tokens_self_delete** — Revoke all auth tokens of the specified requested_token_type created by the authenticated user in DevRev. - **list_all_devrev_service_level_agreement** — List SLAs in DevRev. Returns fields including id, name, status, created_by, created_date, description, evaluation_period, modified_by, modified_date, policies, and sla_type. - **get_single_devrev_service_level_agreement_by_id** — Get an SLA by id in DevRev. Returns fields including id, name, status, created_by, created_date, description, display_id, evaluation_period, modified_by, modified_date, policies, and sla_type. - **create_a_devrev_service_level_agreement** — Create an SLA in draft status in DevRev. Requires name. Returns id, name, status, account_filter, compensation, created_by, created_date, description, display_id, evaluation_period, modified_by, modified_date, policies, and sla_type. - **update_a_devrev_service_level_agreement_by_id** — Update a draft service-level-agreement (SLA) by id in DevRev. Returns the updated SLA object including id, name, description, evaluation_period, and policies. - **devrev_service_level_agreement_assign** — Assign SLA to a set of Rev organizations in DevRev. Requires rev_orgs list of strings and optional id for the SLA to assign. Returns results with the outcome for each Rev organization. - **devrev_service_level_agreement_transition** — Change the status of a service-level-agreement by providing id and status in DevRev. Returns the updated SLA object with 14 properties reflecting the new status. - **list_all_devrev_sla_trackers** — List SLA trackers in DevRev. Returns fields including id, metric_target_summaries (metric_definition id, display_id, name, stage, breached_at, completed_at, completed_in, in_policy, is_out_of_schedule, next_schedule_transition, org_schedule details, remaining_time, status, target_time, warning_target_time), applies_to_id, applies_to_type, created_by and modified_by user details, created_date, display_id, modified_date, removed_sla_metric_history, sla details (id, name, status, display_id, sla_type), sla_policy_id, stage, and status. - **get_single_devrev_sla_tracker_by_id** — Get SLA tracker by id in DevRev. Returns sla_tracker object with detailed SLA tracker properties. - **list_all_devrev_metric_definitions** — List metric definitions in DevRev. Returns metric_definitions array with details about each metric definition. Supports filtering by applies_to_type, status, and type. - **devrev_keyrings_authorize** — Authorize keyrings using code and state parameters in DevRev. Returns OAuth2 authorization callback response. ## How it works 1. **Link your customer's DevRev account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach DevRev.** The Proxy API is a 1-to-1 mapping of the DevRev API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Sync customer identity and account data into DevRev's knowledge graph** — B2B SaaS companies with billing or CRM data can push account tiers, domains, and rev_user identities into DevRev so their customers' support tickets are automatically prioritized by revenue impact — without manual data entry. - **Automate ticket and issue creation from external signals** — Observability, error-tracking, or feedback tools can programmatically create DevRev works (tickets or issues) linked to specific product parts, attaching artifacts like stack traces or logs, so engineering teams get full context without switching tools. - **Build event-driven status sync via webhooks** — SaaS products can subscribe to DevRev webhook events to detect when a work item is resolved or an SLA is breached, then push real-time status updates back to their own UI — closing the loop between developers and end customers. - **Escalate AI chatbot conversations to human agents in DevRev** — Customer support automation platforms can create DevRev conversations with full chat transcripts as timeline entries, linking the rev_user so human agents can pick up exactly where the bot left off without asking the customer to repeat themselves. - **Enrich product feedback with DevRev's parts taxonomy** — Feedback and roadmap tools can query DevRev's parts hierarchy to let end users tag requests to specific product components, then check for existing work items to avoid duplicates and aggregate customer demand signals on a single issue. ## What you can build - **Two-way ticket and issue sync** — Create, update, and read DevRev works (tickets and issues) from your product, and listen for status changes via webhooks to keep both systems in lockstep. - **Automated account tier synchronization** — Push CRM or billing tier changes into DevRev accounts so support routing and SLA enforcement automatically reflect a customer's current plan. - **Contextual artifact attachment pipeline** — Upload error logs, screenshots, or JSON payloads as DevRev artifacts and link them to works or timeline entries so developers get immediate diagnostic context. - **Product component picker powered by DevRev parts** — Fetch the customer's parts taxonomy via the API and render it in your own UI, letting end users tag bug reports or feature requests to the exact product component. - **Threaded conversation escalation from chat widgets** — Create DevRev conversations and append timeline entries containing chat transcripts, linked to the correct rev_user, for seamless handoff from automated to human support. - **User directory sync via Unified API** — Use Truto's Unified User Directory API to read and manage DevRev users, groups, and organizations alongside other apps your customers already use — with a single schema. ## FAQs ### What authentication method does the DevRev integration use? ### Can I create both tickets and issues through a single endpoint? Yes. DevRev treats both tickets and issues as 'works'. You use create_a_devrev_work and specify the type (ticket or issue), along with the part it applies to, to route it correctly. ### Does the integration support webhooks for real-time event notifications? Yes. You can create, list, update, and delete DevRev webhooks through Truto, and handle incoming webhook events via devrev_webhooks_event to react to status changes, new comments, and other triggers in real time. ### What Unified APIs are available for DevRev? DevRev is mapped to Truto's Unified User Directory API, which covers Groups, Me, Organizations, and Users. This lets you normalize DevRev identity data alongside other integrations using a single schema. ### Can I manage SLAs programmatically through this integration? Yes. The integration supports creating, updating, listing, and retrieving service level agreements, as well as assigning and transitioning SLAs. You can also list and retrieve SLA trackers to monitor compliance. ### How does pagination and rate limiting work? Truto abstracts pagination across all DevRev list endpoints so you receive consistent cursored responses regardless of DevRev's native pagination style. Rate limit handling, including retries and backoff, is managed by Truto automatically.