methodatlas
Method guideTeam Design

Team API

A practical method guide: clarify prerequisites and materials, understand the complete process, and look up outputs, pitfalls, and stop criteria.

ComplexityLow
TimeHalf day initial, dann laufend
ParticipantsEin Team plus Stakeholder
FormatWorkshop + async
MaturityEmerging
Plan Team API
01

Prerequisite

What needs to be finished first

Complete firstBounded subject

The scope and purpose of Team API are stated as a concrete question.

Without scope, team API becomes arbitrary.
Complete firstAccess to relevant perspectives

Team mission and services, dependencies and contact routes, work and support data and domain decision makers are available.

Without these perspectives, central claims in team API remain unsupported.
02

Preparation

What needs to be ready before start

Materials

Team mission and services, dependencies and contact routes, work and support data, shared workspace, source links, and decision log.

People / roles

Whole team · team lead · key consuming teams

Pre-read

Collect Team mission and services, dependencies and contact routes, work and support data in advance and mark open assumptions.

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.

03

Core question

The one question this method answers

What must other teams know to work effectively with this team with minimal disruption?

04

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.

Team Topologies: Team API template

  1. 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. 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. 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. 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

05

Artifact

What comes out at the end

Sketch: what the artifact looks like

Team API · Make Team Interfaces ExplicitDescribe team purpose, responsibilities, offered services, expectations, and communication paths as an API between teams
Team APIThe visual shows a team as an API with required inputs, offered services, boundaries, expectations, service levels, and communication paths.Describe collaboration as a clear team interfaceA Team API makes visible what a team offers, needs, refuses, and how other teams can connect reliably.Needs from othersdata, decisions, platformsNot responsible forexplicit boundaries against driftOffersservices, advice, artifactsExpects from usersinputs, quality, lead timeService levelresponse time, quality, escalationCommunication pathschannels and sync cadenceTeam APIpurpose, ownership, and work boundariesDependency visibleAPI over ad hoc asksWorking agreement
Form

Versioned team API with date, sources, owners, and next review.

Versioning / ownership

Retain date, source, assumption state, and decision for every version of team API.

Tool alternatives
  • 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

06

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.

07

Pitfalls

Recognize symptoms and steer against them

Quick overview, the full text is in the matching phase in the flow

  1. Mission/ownershipThe team API becomes an org chart or promises support the team cannot sustain.View in phase
  2. InterfacesThe team API becomes an org chart or promises support the team cannot sustain.View in phase
  3. Ways of workingThe team API becomes an org chart or promises support the team cannot sustain.View in phase
  4. Consumer reviewThe team API becomes an org chart or promises support the team cannot sustain.View in phase
08

Stop criteria

When to pause, resolve prerequisites, or choose another approach

team API answers the core question with traceable evidence or explicitly marked uncertainty.
Owners, next actions, and review dates are named for open points.

Method after Matthew Skelton and Manuel Pais. Curated with 1 sources.

Sources: Team Topologies: Team API template

Flow, timeboxes, and pitfalls are editorially curated practice recommendations based on the listed sources.

Finished the method guide?

Go to the profile for purpose, similar methods, and sources or continue to the next method in the catalog.