Get a List of Manual Measures

Description	Get a list of manual measures
URL	/api/manual_measures
HTTP Method	GET
Response Formats	json
Security	Requires User role on the project

Examples

Use Case	Example Request
Get all the manual measures on project 'myProject'	GET http://localhost:9000/api/manual_measures?resource=myProject
Get the manual measure on metric 'business_value' on project 'myProject'	GET http://localhost:9000/api/manual_measures?resource=myProject&metric=business_value

Response Format

[
  {
    "id":10,
    "metric":"business_value",
    "resource":"java-sonar-runner-simple",
    "val":10.2,
    "desc":"blabla",
    "created_at":"2012-10-10T18:12:23+0200",
    "updated_at":"2012-10-10T18:12:23+0200",
    "login":"admin",
    "username":"Administrator"
  },
  ...
]

Parameters

Parameter

Description

Required

Default Value

Example Value

resource

id or key of the project

Yes

None

org.codehaus.sonar:sonar

metric

id of the manual metric

No

None

business_value

format

Response format can be set through:

Parameter format: json
Or the 'Accept' property in the HTTP header:

- Accept:application/json

If nothing is set, json is used.

No

None

json

Create a Manual Measure

Description	Create a manual measure
URL	/api/manual_measures
HTTP Method	POST
Security	Requires Project Administrator role on the project

Examples

Use Case	Example Request
Create a manual measure on project 'myProject' being logged in as user 'admin/admin': Manual metric: business_value Value: 5000 Description: myDescription	curl -u admin:admin -d "resource=myProject&metric=business_value&val=5000&desc=myDescription" http://localhost:9000/api/manual_measures

Parameters

Parameter	Description	Required	Default Value	Example Value
resource	id or key of the project	Yes	None	org.codehaus.sonar:sonar
metric	Key of the manual metric	Yes	None	business_value
val	Decimal value of the manual measure	Yes (or text is set)	None	10.0
text	Text value of the manual measure	Yes (or val is set)	None	abc
desc	Description	No	None	myDescription

Delete a Manual Measure

Description	Delete a manual measure
URL	/api/manual_measures
HTTP Method	DELETE
Security	Requires Project Administrator role on the project

Examples

Use Case	Example Request
Delete manual measure 'business_value' on project 'myProject'	curl -u admin:admin -X DELETE "http://localhost:9000/api/manual_measures?resource=myProject&metric=business_value"

Parameters

Parameter	Description	Required	Default Value	Example Value
resource	id or key of the project	Yes	None	org.codehaus.sonar:sonar
metric	Key of the manual metric	Yes	None	business_value