The scope and purpose of Team API are stated as a concrete question.
Team API
A practical method guide: clarify prerequisites and materials, understand the complete process, and look up outputs, pitfalls, and stop criteria.
Prerequisite
What needs to be finished first
Team mission and services, dependencies and contact routes, work and support data and domain decision makers are available.
Preparation
What needs to be ready before start
Team mission and services, dependencies and contact routes, work and support data, shared workspace, source links, and decision log.
Whole team · team lead · key consuming teams
Collect Team mission and services, dependencies and contact routes, work and support data in advance and mark open assumptions.
90 minutes initially; 30-minute review
Prepare explicit team contract covering mission, ownership, interfaces, and working preferences visibly and calibrate assessment terms before starting.
Core question
The one question this method answers
What must other teams know to work effectively with this team with minimal disruption?
Flow
Phases with goal, actions, output and pitfall
A Team API describes how others work with a team. It covers owned services, communication routes, work preferences, and known constraints and is maintained jointly.
team API
Fictional worked example
explicit team contract covering mission, ownership, interfaces, and working preferences as a precise working structure with a fictional example.
Mission and services
Purpose · outcomes · ownership
Secure self-service deployments; deployment API.
Consumers and interaction
Need · mode · contact
X-as-a-Service; office hour for new integration.
Ways of working
Support · response · preference
#platform-help; P1 via pager.
Boundaries and review
Out of scope · review date · owner
No app data migration; review 15 October.
The example demonstrates the domain logic of Team API; worksheets remain blank.
- 1
Mission
Mission/ownership

Goal
Produce ownership profile so the core question “What must other teams know to work effectively with this team with minimal disruption?” can be answered with stronger support.
Inputs for this step
- Team mission and services
- dependencies and contact routes
- work and support data
Actions
- Name team purpose, owned services, and boundaries.
- Record source, rationale, and open uncertainty directly in ownership profile.
Output
ownership profile
ownership profile · source · uncertainty · next decision
Quality check
Are responsibilities expressed as services or outcomes?
Pitfall
The team API becomes an org chart or promises support the team cannot sustain. Test against real consumer situations, clarify ownership and response routes, and remove unsustainable promises.
Timing: 10–20 minutes
- 2
Interfaces
Interfaces

Goal
Produce interaction catalogue so the core question “What must other teams know to work effectively with this team with minimal disruption?” can be answered with stronger support.
Inputs for this step
- ownership profile
- dependencies and contact routes
- work and support data
Actions
- Describe consumer, interaction mode, and contact route per need.
- Record source, rationale, and open uncertainty directly in interaction catalogue.
Output
interaction catalogue
interaction catalogue · source · uncertainty · next decision
Quality check
Is there one clear route for every need?
Pitfall
The team API becomes an org chart or promises support the team cannot sustain. Test against real consumer situations, clarify ownership and response routes, and remove unsustainable promises.
Timing: 10–20 minutes
- 3
Ways of working
Ways of working

Goal
Produce collaboration rules so the core question “What must other teams know to work effectively with this team with minimal disruption?” can be answered with stronger support.
Inputs for this step
- interaction catalogue
- dependencies and contact routes
- work and support data
Actions
- Agree working preferences, support, and response rules.
- Record source, rationale, and open uncertainty directly in collaboration rules.
Output
collaboration rules
collaboration rules · source · uncertainty · next decision
Quality check
Are commitments realistic and measurable?
Pitfall
The team API becomes an org chart or promises support the team cannot sustain. Test against real consumer situations, clarify ownership and response routes, and remove unsustainable promises.
Timing: 10–20 minutes
- 4
Consumer review
Consumer review

Goal
Produce validated team API so the core question “What must other teams know to work effectively with this team with minimal disruption?” can be answered with stronger support.
Inputs for this step
- collaboration rules
- dependencies and contact routes
- work and support data
Actions
- Walk through the API with two consumer teams and correct gaps.
- Record source, rationale, and open uncertainty directly in validated team API.
Output
validated team API
validated team API · source · uncertainty · next decision
Quality check
Can consumers find ownership and contact without asking?
Pitfall
The team API becomes an org chart or promises support the team cannot sustain. Test against real consumer situations, clarify ownership and response routes, and remove unsustainable promises.
Timing: 10–20 minutes
Artifact
What comes out at the end
Sketch: what the artifact looks like
Versioned team API with date, sources, owners, and next review.
Retain date, source, assumption state, and decision for every version of team API.
- team API as board or document
- Source and evidence register
- Decision and action log
team-api-working-template.md
Plan Team API around its domain steps and the concrete decision question.
Team API: Worksheet
Question
To be confirmed
Desired outcome
To be confirmed
Scope
Establish and review the practice Time: 90 minutes initially; 30-minute review
Complete this worksheet on paper or in your own document during the work.
Preparation for this scope
Method setup
- Materials: Team mission and services, dependencies and contact routes, work and support data, shared workspace, source links, and decision log.
- Roles: Whole team · team lead · key consuming teams
- Advance information: Collect Team mission and services, dependencies and contact routes, work and support data in advance and mark open assumptions.
- Overall time needed: 90 minutes initially; 30-minute review
- Setup: Prepare explicit team contract covering mission, ownership, interfaces, and working preferences visibly and calibrate assessment terms before starting.
Prepare for the work steps
Mission: Mission/ownership
- Team mission and services
- dependencies and contact routes
- work and support data
Interfaces: Interfaces
- ownership profile
- dependencies and contact routes
- work and support data
Ways of working: Ways of working
- interaction catalogue
- dependencies and contact routes
- work and support data
Consumer review: Consumer review
- collaboration rules
- dependencies and contact routes
- work and support data
team API
Mission and services
Purpose · outcomes · ownership
...
Consumers and interaction
Need · mode · contact
...
Ways of working
Support · response · preference
...
Boundaries and review
Out of scope · review date · owner
...
Enter only real input, sources, and decisions.
Team Topologies: Team API template
Mission: Mission/ownership
Expected artifact: ownership profile
ownership profile · source · uncertainty · next decision
Entry:
...
- Are responsibilities expressed as services or outcomes?
Interfaces: Interfaces
Expected artifact: interaction catalogue
interaction catalogue · source · uncertainty · next decision
Entry:
...
- Is there one clear route for every need?
Ways of working: Ways of working
Expected artifact: collaboration rules
collaboration rules · source · uncertainty · next decision
Entry:
...
- Are commitments realistic and measurable?
Consumer review: Consumer review
Expected artifact: validated team API
validated team API · source · uncertainty · next decision
Entry:
...
- Can consumers find ownership and contact without asking?
Open questions and next steps
...
Method guide: https://methodatlas.meierhoff-systems.de/en/methods/team-api/run-sheet
Example output
Concrete filled scenario, fictional example
Fictional example for orientation. Counts and timings describe this case and are not universal requirements.
team-api-beispiel.md
Concrete filled scenario, fictional example
Mission: secure self-service deployments. Ownership: deployment API and golden path. Interaction: X-as-a-Service; 30-minute office hour for new integrations. Support: #platform-help, P1 via pager. Known boundary: no application-specific data migrations.
Pitfalls
Recognize symptoms and steer against them
Quick overview, the full text is in the matching phase in the flow
- Mission/ownershipThe team API becomes an org chart or promises support the team cannot sustain.View in phase
- InterfacesThe team API becomes an org chart or promises support the team cannot sustain.View in phase
- Ways of workingThe team API becomes an org chart or promises support the team cannot sustain.View in phase
- Consumer reviewThe team API becomes an org chart or promises support the team cannot sustain.View in phase
Mission/ownership
The team API becomes an org chart or promises support the team cannot sustain.
Test against real consumer situations, clarify ownership and response routes, and remove unsustainable promises.
Interfaces
The team API becomes an org chart or promises support the team cannot sustain.
Test against real consumer situations, clarify ownership and response routes, and remove unsustainable promises.
Ways of working
The team API becomes an org chart or promises support the team cannot sustain.
Test against real consumer situations, clarify ownership and response routes, and remove unsustainable promises.
Consumer review
The team API becomes an org chart or promises support the team cannot sustain.
Test against real consumer situations, clarify ownership and response routes, and remove unsustainable promises.
Stop criteria
When to pause, resolve prerequisites, or choose another approach
Finished the method guide?
Go to the profile for purpose, similar methods, and sources or continue to the next method in the catalog.

