Overview

Codeberg is a free, nonprofit-operated software development platform that provides Git repository hosting, issue tracking, and collaboration tools powered by the open-source Forgejo engine. Persona's Codeberg integration enables your workflows to automatically open, update, and comment on issues in your repositories — keeping your engineering backlog in sync with identity events without manual handoff.

Benefits

Automate Issue Creation: Automatically open Codeberg issues when Persona detects an anomaly, a failed verification, or any event that requires engineering attention.

Keep Issues in Sync: Update issue state, title, assignees, or labels from Persona workflows so your backlog reflects the current status of identity-related work.

Maintain an Audit Trail: Post comments on issues automatically to log Persona decision events, timestamps, and supporting context for compliance and review purposes.

Organize with Labels: Apply labels programmatically to categorize and triage issues by severity, type, or team without manual tagging.

Support Open-Source and Self-Hosted Teams: For teams using Codeberg as their primary dev platform, this integration surfaces identity operations directly in the development workflow.

Integration Features

Persona's Codeberg integration enables automation across issue management workflows. Key capabilities include:

• List Issues: Return a paginated, filterable list of issues in a repository with rich filtering options.
• Create Issue: Open new issues with title, body, assignees, labels, and milestone.
• Get Issue: Retrieve full details of a specific issue by number.
• Update Issue: Update an existing issue's title, body, state, assignees, labels, or due date.
• Create Issue Comment: Post comments for audit logs or workflow notes.
• Add Issue Label: Apply one or more labels to existing issues for categorization and triage.

Setting up the Codeberg integration

Prerequisites

To set up the Codeberg integration, ensure you have:

• A Codeberg account with access to the target repository
• A Codeberg API token (generated in account settings under Applications)
• The owner name and repository name you want to manage issues in

Setting up the Codeberg credentials

1. In the Persona Dashboard, navigate to Integrations > Marketplace and click on Codeberg.
2. Click on Add Credential at the top of the page.
3. Enter a Nickname for Credential in the modal, along with your Codeberg API token, and click Continue.
4. Once complete, the credential will appear in Persona and can be selected in workflows.

Using the Codeberg integration in a workflow

1. Create a new workflow, or open an existing workflow you'd like to update.
2. Add a new action step > Integrations.
3. Select the Codeberg integration and choose your Codeberg credential.
4. Select the operation you want to run and map Persona data into the input fields.
5. Save and publish the workflow.

Codeberg Operations Overview

Persona supports multiple Codeberg API operations for managing issues within your repositories. These actions allow you to automate issue creation, updates, commenting, and labeling, ensuring engineering work is tracked in Codeberg based on Persona events.

See below for a comprehensive list of available Workflow Action steps and possible configurations for the Codeberg integration:

List Issues

Retrieve a paginated, filterable list of issues in a specified repository. Use this to look up existing issues before creating new ones or to surface relevant issues in downstream workflow steps.

Configuration Steps:

• Provide values for required fields:
  • Owner
  • Repository Name
• Optionally add:
  • State (open, closed, all)
  • Labels
  • Query
  • Type
  • Milestones
  • Since
  • Before
  • Created By
  • Assigned By
  • Mentioned By
  • Page
  • Limit
  • Sort

Create Issue

Open a new issue in a specified repository with a title, body, assignees, labels, and milestone.

Configuration Steps:

• Provide values for required fields:
  • Owner
  • Repository Name
  • Title
• Optionally add:
  • Body
  • Assignees
  • Labels
  • Milestone ID
  • Due Date

Get Issue

Retrieve the full details of a specific issue by repository and issue number.

Configuration Steps:

• Provide values for required fields:
  • Owner
  • Repository Name
  • Issue Number

Update Issue

Update an existing issue's title, body, state, assignees, labels, or due date. Use this to close issues or reflect updated status from Persona events.

Configuration Steps:

• Provide values for required fields:
  • Owner
  • Repository Name
  • Issue Number
• Optionally add:
  • Title
  • Body
  • State (open or closed)
  • Assignees
  • Labels
  • Milestone
  • Due Date
  • Unset Due Date (true/false)

Create Issue Comment

Post a comment on an existing issue for audit logs, status updates, or workflow notes.

Configuration Steps:

• Provide values for required fields:
  • Owner
  • Repository Name
  • Issue Number
  • Body (comment text)

Add Issue Label

Apply one or more labels to an existing issue for categorization and triage.

Configuration Steps:

• Provide values for required fields:
  • Owner
  • Repository Name
  • Issue Number
  • Labels (array of label IDs)

FAQs

How do I find my repository's label IDs?

Use the Codeberg API or your repository's Labels settings page to look up label IDs. You can also create labels in advance and hardcode their IDs in your workflow.

Is the Codeberg instance configurable?

The integration connects to the public codeberg.org instance. Self-hosted Forgejo instances are not currently supported..